Skip to main content
GET
/
organizations
Listar Organizacoes
curl --request GET \
  --url https://api.example.com/organizations \
  --header 'Authorization: <authorization>'
{
  "data": [
    {
      "organizationId": "019525fd-4c38-7e30-a5c1-b6e3f4d8a9c2",
      "billingThresholdId": "019525fd-a068-7e7c-d4f0-6a8b0c2e4f6c",
      "subscriptionId": "019525fd-b17c-7f8d-e5a1-7b9c1d3f5a7d",
      "iamExternalRef": "org_workos_abc123",
      "billingExternalRef": "cus_stripe_abc123",
      "name": "Acme Inc",
      "email": "billing@acme.com",
      "currency": "BRL",
      "phone": "+5511999999999",
      "address": {
        "line1": "Av Paulista 1000",
        "line2": null,
        "city": "Sao Paulo",
        "state": "SP",
        "postalCode": "01310-100",
        "country": "BR"
      },
      "taxId": "12345678000100",
      "taxType": "CNPJ",
      "offboardingStatus": "ACTIVE",
      "createdAt": "2026-01-15T10:00:00.000Z",
      "updatedAt": "2026-03-01T10:00:00.000Z"
    }
  ],
  "meta": { "page": 1, "limit": 20, "totalItems": 50, "totalPages": 3 }
}
Requer permissao organizations:read.

Headers

Authorization
string
required
Bearer token.

Parametros de Query

page
integer
Numero da pagina.
limit
integer
Resultados por pagina.
Buscar por nome ou email.
sortBy
string
Campo de ordenacao.
sortOrder
string
Direcao da ordenacao.

Resposta

data
array
Lista de organizacoes.
meta
object
Metadados de paginacao.
{
  "data": [
    {
      "organizationId": "019525fd-4c38-7e30-a5c1-b6e3f4d8a9c2",
      "billingThresholdId": "019525fd-a068-7e7c-d4f0-6a8b0c2e4f6c",
      "subscriptionId": "019525fd-b17c-7f8d-e5a1-7b9c1d3f5a7d",
      "iamExternalRef": "org_workos_abc123",
      "billingExternalRef": "cus_stripe_abc123",
      "name": "Acme Inc",
      "email": "billing@acme.com",
      "currency": "BRL",
      "phone": "+5511999999999",
      "address": {
        "line1": "Av Paulista 1000",
        "line2": null,
        "city": "Sao Paulo",
        "state": "SP",
        "postalCode": "01310-100",
        "country": "BR"
      },
      "taxId": "12345678000100",
      "taxType": "CNPJ",
      "offboardingStatus": "ACTIVE",
      "createdAt": "2026-01-15T10:00:00.000Z",
      "updatedAt": "2026-03-01T10:00:00.000Z"
    }
  ],
  "meta": { "page": 1, "limit": 20, "totalItems": 50, "totalPages": 3 }
}

Exemplos de Codigo

curl https://api.awsales.io/admin/organizations?page=1&limit=20 \
  -H "Authorization: Bearer YOUR_ACCESS_TOKEN"

Codigos de Erro

StatusCodigoDescricao
400validation_errorEntrada invalida ou campos obrigatorios ausentes
401unauthorizedAutenticacao ausente ou invalida
403forbiddenPermissoes insuficientes
500internal_server_errorOcorreu um erro inesperado