curl --request GET \
--url https://api.hubfy.io/v1/customers/{id} \
--header 'Authorization: Bearer <token>'const options = {method: 'GET', headers: {Authorization: 'Bearer <token>'}};
fetch('https://api.hubfy.io/v1/customers/{id}', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));import requests
url = "https://api.hubfy.io/v1/customers/{id}"
headers = {"Authorization": "Bearer <token>"}
response = requests.get(url, headers=headers)
print(response.text){
"id": "cus_1234567890abcdef",
"city": null,
"country": null,
"created_at": "2030-01-01T00:00:00.000Z",
"currency": "BRL",
"document": null,
"document_type": null,
"email": "cliente@example.com",
"email_marketing_status": "subscribed",
"external_id": null,
"first_name": null,
"last_name": null,
"metadata": {},
"mrr_cents": 0,
"name": "Cliente Exemplo",
"object": "customer",
"phone": null,
"region": null,
"total_revenue_cents": 0,
"updated_at": "2030-01-01T00:00:00.000Z"
}{
"error": {
"code": "invalid_parameter",
"doc_url": null,
"message": "The request contains invalid parameters",
"param": null,
"type": "invalid_request_error"
}
}{
"error": {
"code": "invalid_parameter",
"doc_url": null,
"message": "The request contains invalid parameters",
"param": null,
"type": "invalid_request_error"
}
}{
"error": {
"code": "invalid_parameter",
"doc_url": null,
"message": "The request contains invalid parameters",
"param": null,
"type": "invalid_request_error"
}
}{
"error": {
"code": "invalid_parameter",
"doc_url": null,
"message": "The request contains invalid parameters",
"param": null,
"type": "invalid_request_error"
}
}{
"error": {
"code": "invalid_parameter",
"doc_url": null,
"message": "The request contains invalid parameters",
"param": null,
"type": "invalid_request_error"
}
}{
"error": {
"code": "invalid_parameter",
"doc_url": null,
"message": "The request contains invalid parameters",
"param": null,
"type": "invalid_request_error"
}
}{
"error": {
"code": "invalid_parameter",
"doc_url": null,
"message": "The request contains invalid parameters",
"param": null,
"type": "invalid_request_error"
}
}{
"error": {
"code": "invalid_parameter",
"doc_url": null,
"message": "The request contains invalid parameters",
"param": null,
"type": "invalid_request_error"
}
}{
"error": {
"code": "invalid_parameter",
"doc_url": null,
"message": "The request contains invalid parameters",
"param": null,
"type": "invalid_request_error"
}
}Obter um cliente
Operação sobre clientes da conta.
curl --request GET \
--url https://api.hubfy.io/v1/customers/{id} \
--header 'Authorization: Bearer <token>'const options = {method: 'GET', headers: {Authorization: 'Bearer <token>'}};
fetch('https://api.hubfy.io/v1/customers/{id}', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));import requests
url = "https://api.hubfy.io/v1/customers/{id}"
headers = {"Authorization": "Bearer <token>"}
response = requests.get(url, headers=headers)
print(response.text){
"id": "cus_1234567890abcdef",
"city": null,
"country": null,
"created_at": "2030-01-01T00:00:00.000Z",
"currency": "BRL",
"document": null,
"document_type": null,
"email": "cliente@example.com",
"email_marketing_status": "subscribed",
"external_id": null,
"first_name": null,
"last_name": null,
"metadata": {},
"mrr_cents": 0,
"name": "Cliente Exemplo",
"object": "customer",
"phone": null,
"region": null,
"total_revenue_cents": 0,
"updated_at": "2030-01-01T00:00:00.000Z"
}{
"error": {
"code": "invalid_parameter",
"doc_url": null,
"message": "The request contains invalid parameters",
"param": null,
"type": "invalid_request_error"
}
}{
"error": {
"code": "invalid_parameter",
"doc_url": null,
"message": "The request contains invalid parameters",
"param": null,
"type": "invalid_request_error"
}
}{
"error": {
"code": "invalid_parameter",
"doc_url": null,
"message": "The request contains invalid parameters",
"param": null,
"type": "invalid_request_error"
}
}{
"error": {
"code": "invalid_parameter",
"doc_url": null,
"message": "The request contains invalid parameters",
"param": null,
"type": "invalid_request_error"
}
}{
"error": {
"code": "invalid_parameter",
"doc_url": null,
"message": "The request contains invalid parameters",
"param": null,
"type": "invalid_request_error"
}
}{
"error": {
"code": "invalid_parameter",
"doc_url": null,
"message": "The request contains invalid parameters",
"param": null,
"type": "invalid_request_error"
}
}{
"error": {
"code": "invalid_parameter",
"doc_url": null,
"message": "The request contains invalid parameters",
"param": null,
"type": "invalid_request_error"
}
}{
"error": {
"code": "invalid_parameter",
"doc_url": null,
"message": "The request contains invalid parameters",
"param": null,
"type": "invalid_request_error"
}
}{
"error": {
"code": "invalid_parameter",
"doc_url": null,
"message": "The request contains invalid parameters",
"param": null,
"type": "invalid_request_error"
}
}customers:read ou read. Veja campos, relacionamentos e eventos.Authorizations
Bearer authentication header of the form Bearer <token>, where <token> is your auth token.
Path Parameters
ID público do cliente na conta.
^cus_[a-z0-9]{16}$Response
Operação concluída
Identificador público estável. Use o valor retornado pela API nas consultas e relacionamentos; não derive IDs de nomes.
^cus_[a-z0-9]{16}$Cidade do cliente; null quando ausente.
País informado no cadastro; null quando ausente.
Data e hora da criação, em ISO 8601 com fuso horário. Somente leitura.
Moeda dos indicadores do cliente. Pode ser null. Somente leitura.
Documento do cliente como string, preservando zeros à esquerda; null quando ausente.
Tipo do documento informado, como cpf ou cnpj; null quando ausente.
Email do cliente. Obrigatório e não vazio na criação; convertido para minúsculas ao criar.
Situação de email marketing: subscribed, unsubscribed, archived, requires_verification, invalid_email ou bounced.
Identificador do cliente no seu sistema. Pode ser null. Não substitui o id da Hubfy.
Primeiro nome; null quando ausente.
Sobrenome; null quando ausente.
Objeto JSON livre para referências da integração, limitado a 16 KB. Ao enviar, substitui todo o metadata anterior; use {} para limpar. Não aceita null.
Receita recorrente mensal registrada para o cliente, em centavos. Somente leitura.
Nome do cliente. Obrigatório e não vazio na criação.
Tipo do objeto retornado. O valor é fixo para este recurso.
"customer"Telefone do cliente como string; null quando ausente.
Estado ou região do cliente; null quando ausente.
Receita acumulada registrada para o cliente, em centavos. Não deve ser enviada em criação ou atualização.
Data e hora da última alteração, em ISO 8601 com fuso horário. Somente leitura.