Listar endereços de uma conta

Para obter informações sobre endereços cadastrados, você pode:

  1. Lista endereços de uma conta
  2. Busca um endereço especifico

Passos para Integrar

  1. Realizar autenticação na API.
  2. Realizar a consulta das informações.

Lista endereços de uma conta

Para obter informações sobre os diversos endereços vinculados a uma conta, envie uma requisição com o ID da conta para o endpoint correspondente.

curl -X 'GET' \
  'https://kubernetes-prod.celcoin.dev/api/accounts/1/address' \
  -H 'accept: application/json' \
  -H 'Bearer: {TOKEN}'

👍

Sucesso 200

{
  "version": "1.0.0",
  "status": 200,
  "body": [
    {
      "enderecoId": 59,
      "tipoEndereco": "R",
      "endereco": "Rua 15",
      "numero": "13",
      "bairro": "Farolândia",
      "cidade": "Aracaju",
      "estado": "SE",
      "pais": "BRA",
      "cep": "49100000",
      "enderecoCorrespondencia": false,
      "complemento": "Próximo a praça",
      "dataCriacao": "2024-06-04T13:29:31.000000Z",
      "dataAtualizacao": "2024-06-04T15:22:37.000000Z",
      "ativo": false
    }
  ]
}
CampoTipoDescrição
endercoIdintId do endereço gerado na criação da conta ou criação do endereço
tipoEnderecocharIndica o Logradouro do endereço, R - Rua, A - Avenida
enderecostring (50)Nome da rua ou avenida
numerostring (10)Numero do local
bairrostring (20)Bairro em que se encontra o endereço
cidadestring (20)Cidade em que se encontra o endereço
estadostring (2)Estado em que se encontra o endereço
paisstring (3)Pais em que se encontra o endereço
cepstring (10)Código de Endereçamento Postal
enderecoCorrespondenciabooleanIndica se é o endereço que o cliente deve receber os cartões
complementostring (30)Complemento da localização
dataCriacaostring (50)Data em que foi cadastrado este endereço
dataAtualizacaostring (50)Data da ultima atualização do endereço
ativobooleanSe este endereço permanece ativo ou desativado

Buscar um endereço em específico

Para obter informações de um endereço específico, envie uma requisição com o ID do endereço para o endpoint correspondente.

curl -X 'GET' \
  'https://kubernetes-prod.celcoin.dev/api/accounts/1/address/1' \
  -H 'accept: application/json' \
  -H 'Bearer: {TOKEN}'

👍

Sucesso 200

{
  "version": "1.0.0",
  "status": 200,
  "body": {
    "enderecoId": 59,
    "tipoEndereco": "R",
    "endereco": "Rua 15",
    "numero": "13",
    "bairro": "Farolândia",
    "cidade": "Aracaju",
    "estado": "SE",
    "pais": "BRA",
    "cep": "49100000",
    "enderecoCorrespondencia": false,
    "complemento": "Próximo a praça",
    "dataCriacao": "2024-06-04T13:29:31.000000Z",
    "dataAtualizacao": "2024-06-04T15:22:37.000000Z",
    "ativo": false
  }
}
CampoTipoDescrição
endercoIdintId do endereço gerado na criação da conta ou criação do endereço
tipoEnderecocharIndica o Logradouro do endereço, R - Rua, A - Avenida
enderecostring (50)Nome da rua ou avenida
numerostring (10)Numero do local
bairrostring (20)Bairro em que se encontra o endereç
cidadestring (20)Cidade em que se encontra o endereço.
estadostring (2)Estado em que se encontra o endereço
paisstring (3)Pais em que se encontra o endereço
cepstring (10)Código de Endereçamento Postal
enderecoCorrespondenciabooleanIndica se é o endereço que o cliente deve receber os cartões
complementostring (30)Complemento da localização
dataCriacaostring (50)Data em que foi cadastrado este endereço
dataAtualizacaostring (50)Data da ultima atualização do endereço
ativobooleanSe este endereço permanece ativo ou desativado