Pular para o conteúdo principal
GET
/
v1
/
holders
Listar Titulares
curl --request GET \
  --url https://crm.sandbox.lerian.net/v1/holders \
  --header 'X-Organization-id: <x-organization-id>'
{
  "items": [
    {
      "id": "0194f0ea-2cb2-78c9-b9be-704ba20a9cd8",
      "externalId": "d14a028c2a3a2bc9476102bb288234c415a2b01f828ea62ac5b3e42f",
      "type": "LEGAL_PERSON",
      "name": "ACME Corp LTD",
      "document": "91315026015",
      "addresses": {
        "primary": {
          "line1": "Rua Botucatu 10",
          "line2": "Casa B",
          "zipCode": "04023060",
          "city": "São Paulo",
          "state": "SP",
          "country": "BR",
          "description": "BR address"
        },
        "additional1": {
          "line1": "75020 Odell Grove",
          "line2": "Apt. 181",
          "zipCode": "40969-4460",
          "city": "Rubenport",
          "state": "NH",
          "country": "US",
          "description": "US address"
        },
        "additional2": {
          "line1": "52 Lavender Hill",
          "line2": "Apt. 2",
          "zipCode": "SW11 5RH",
          "city": "Battersea",
          "state": "London",
          "country": "UK",
          "description": "UK address"
        }
      },
      "contact": {
        "primaryEmail": "john_doe@email.com",
        "secondaryEmail": "john.doe@workemail.com",
        "mobilePhone": "5577927967227",
        "otherPhone": "556829443019"
      },
      "naturalPerson": {
        "favoriteName": "Johnny",
        "socialName": "Johnny Doe",
        "gender": "Male",
        "birthDate": "1990-12-01",
        "civilStatus": "Married",
        "nationality": "Brazilian",
        "motherName": "Jane Doe",
        "fatherName": "Richard Doe",
        "status": "Active"
      },
      "legalPerson": {
        "tradeName": "ACME",
        "activity": "Electronic devices development",
        "type": "Limited Liability",
        "foundingDate": "2010-01-01",
        "size": "Medium",
        "status": "Closed",
        "representative": {
          "name": "Jane Doe",
          "document": "98765432100",
          "email": "janedoe@corporate.com",
          "role": "CFO"
        }
      },
      "metadata": {
        "metadata1": "value1",
        "metadata2": 2
      },
      "createdAt": "2025-01-01T00:00:00Z",
      "deletedAt": "2025-01-01T00:00:00Z",
      "updatedAt": "2025-01-01T00:00:00Z"
    },
    {
      "id": "01954e1e-e42d-79eb-a5a0-04a5bcad8272",
      "externalId": "G4K7N8M2",
      "type": "NATURAL_PERSON",
      "name": "John Doe",
      "document": "91315026015",
      "addresses": {
        "primary": {
          "line1": "Street 1",
          "line2": "Street 2",
          "zipCode": "00000-000",
          "city": "New York",
          "state": "NY",
          "country": "US",
          "description": "Home address"
        },
        "additional1": {
          "line1": "Street 1",
          "line2": "Street 2",
          "zipCode": "00000-000",
          "city": "New York",
          "state": "NY",
          "country": "US",
          "description": "Home address"
        },
        "additional2": {
          "line1": "Street 1",
          "line2": "Street 2",
          "zipCode": "00000-000",
          "city": "New York",
          "state": "NY",
          "country": "US",
          "description": "Home address"
        }
      },
      "contact": {
        "primaryEmail": "john.doe@example.com",
        "secondaryEmail": "john.doe@example.com",
        "mobilePhone": "+1555555555",
        "otherPhone": "+1555555555"
      },
      "naturalPerson": {
        "favoriteName": "John",
        "socialName": "John Doe",
        "gender": "Male",
        "birthDate": "1990-01-01",
        "civilStatus": "Single",
        "nationality": "Brazilian",
        "motherName": "Jane Doe",
        "fatherName": "John Doe",
        "status": "Active"
      },
      "legalPerson": {
        "tradeName": "Lerian Studio",
        "activity": "Electronic devices development",
        "type": "Limited Liability",
        "foundingDate": "2025-01-01",
        "size": "Medium",
        "status": "Closed",
        "representative": {
          "name": "John Doe",
          "document": "91315026015",
          "email": "john.doe@example.com",
          "role": "CFO"
        }
      },
      "metadata": {
        "labore46": true,
        "qui_0": true,
        "suntb6e": "enim reprehenderit aliquip"
      },
      "createdAt": "2025-02-28T19:53:22.221Z",
      "updatedAt": "2025-02-28T19:53:22.221Z",
      "deletedAt": null
    },
    {
      "id": "01954e2e-30c9-7302-a4e9-0cd8279546fe",
      "externalId": "G4K7N8M2",
      "type": "NATURAL_PERSON",
      "name": "John Doe",
      "document": "91315026016",
      "addresses": {
        "additional1": {
          "line1": "Street 1",
          "line2": "Street 2",
          "zipCode": "00000-000",
          "city": "New York",
          "state": "NY",
          "country": "US",
          "description": "Home address"
        }
      },
      "contact": {
        "primaryEmail": "john.doe@example.com",
        "secondaryEmail": "john.doe@example.com",
        "mobilePhone": "+1555555555",
        "otherPhone": "+1555555555"
      },
      "naturalPerson": {
        "favoriteName": "John",
        "socialName": "John Doe",
        "gender": "Male",
        "birthDate": "1990-01-01",
        "civilStatus": "Single",
        "nationality": "Brazilian",
        "motherName": "Jane Doe",
        "fatherName": "John Doe",
        "status": "Active"
      },
      "legalPerson": {
        "tradeName": "Lerian Studio",
        "activity": "Electronic devices development",
        "type": "Limited Liability",
        "foundingDate": "2025-01-01",
        "size": "Medium",
        "status": "Closed",
        "representative": {
          "name": "John Doe",
          "document": "91315026015",
          "email": "john.doe@example.com",
          "role": "CFO"
        }
      },
      "metadata": {
        "elit_80": -56805915.286121026
      },
      "createdAt": "2025-02-28T20:10:04.873Z",
      "updatedAt": "2025-02-28T20:10:04.873Z",
      "deletedAt": null
    }
  ],
  "page": 1,
  "limit": 10
}

Cabeçalhos

​
Authorization
string

O token de autorização no formato 'Bearer '.
Importante: Este header é obrigatório se o seu ambiente tiver o Access Manager habilitado. Para mais informações, consulte a documentação do Access Manager.

​
X-Organization-id
string
obrigatório

O identificador único da Organização associada à requisição.

Exemplo:

"01946120-0f45-7c5f-86a0-0ea7c59fdbd4"

​
X-Lerian-Id
string

O identificador único do cliente Lerian, gerado e atribuído pela Lerian.

Exemplo:

"01946120-0f45-7c5f-86a0-0ea7c59fdbd4"

Parâmetros de consulta

​
metadata
string

A chave de metadata fornecida quando o Titular foi criado.

​
limit
integer
padrão:10

O número máximo de itens a serem incluídos na resposta.

​
page
integer
padrão:1

O número da página que você deseja consultar.

​
sort_order
enum<string>

A ordem utilizada para classificar os resultados.

Opções disponíveis:
asc,
desc
​
include_deleted
string

Se true, os Titulares que foram excluídos logicamente (soft delete) também serão incluídos.

​
external_id
string

Filtra titulares pelo ID do seu sistema.

​
document
string

Filtra titulares pelo número do documento.

Resposta

Indica que o recurso foi criado com sucesso e a operação foi concluída conforme esperado.

​
items
object[]
obrigatório

Lista com os itens retornados.

​
page
integer
padrão:1
obrigatório

O número da página retornada.

​
limit
integer
padrão:10
obrigatório

O número de itens a serem incluídos na resposta.