curl --request GET \
--url https://api.despezzas.com/v2/business/contacts \
--header 'Authorization: Basic <encoded-value>'const options = {method: 'GET', headers: {Authorization: 'Basic <encoded-value>'}};
fetch('https://api.despezzas.com/v2/business/contacts', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));import requests
url = "https://api.despezzas.com/v2/business/contacts"
headers = {"Authorization": "Basic <encoded-value>"}
response = requests.get(url, headers=headers)
print(response.text)package main
import (
"fmt"
"net/http"
"io"
)
func main() {
url := "https://api.despezzas.com/v2/business/contacts"
req, _ := http.NewRequest("GET", url, nil)
req.Header.Add("Authorization", "Basic <encoded-value>")
res, _ := http.DefaultClient.Do(req)
defer res.Body.Close()
body, _ := io.ReadAll(res.Body)
fmt.Println(string(body))
}[
{
"created_by_user_id": "0d6b923c-3392-424e-a152-2ee32474e8d5",
"id": "f1e2d3c4-b5a6-4978-8a9b-0c1d2e3f4a5b",
"name": "Distribuidora Alfa",
"type": "supplier",
"address_city": null,
"address_complement": null,
"address_district": null,
"address_number": null,
"address_state": null,
"address_street": null,
"address_zip": null,
"city_code": null,
"createdAt": "2026-09-01T09:00:00.000Z",
"document": "12345678000190",
"document_type": "cnpj",
"email": "contato@alfa.com.br",
"municipal_inscription": null,
"notes": null,
"phone": "1133334444",
"profile_id": "5b2c1e0a-7d3f-4c8e-9a1b-2f6d8e4c7a90",
"updatedAt": "2026-09-15T14:32:10.000Z",
"user_id": null
}
]{
"message": "Credenciais de API inválidas",
"statusCode": 401,
"error": "Unauthorized"
}{
"message": "Credenciais de API inválidas",
"statusCode": 401,
"error": "Unauthorized"
}{
"message": "Credenciais de API inválidas",
"statusCode": 401,
"error": "Unauthorized"
}Listar contatos
Escopo necessário: read.
curl --request GET \
--url https://api.despezzas.com/v2/business/contacts \
--header 'Authorization: Basic <encoded-value>'const options = {method: 'GET', headers: {Authorization: 'Basic <encoded-value>'}};
fetch('https://api.despezzas.com/v2/business/contacts', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));import requests
url = "https://api.despezzas.com/v2/business/contacts"
headers = {"Authorization": "Basic <encoded-value>"}
response = requests.get(url, headers=headers)
print(response.text)package main
import (
"fmt"
"net/http"
"io"
)
func main() {
url := "https://api.despezzas.com/v2/business/contacts"
req, _ := http.NewRequest("GET", url, nil)
req.Header.Add("Authorization", "Basic <encoded-value>")
res, _ := http.DefaultClient.Do(req)
defer res.Body.Close()
body, _ := io.ReadAll(res.Body)
fmt.Println(string(body))
}[
{
"created_by_user_id": "0d6b923c-3392-424e-a152-2ee32474e8d5",
"id": "f1e2d3c4-b5a6-4978-8a9b-0c1d2e3f4a5b",
"name": "Distribuidora Alfa",
"type": "supplier",
"address_city": null,
"address_complement": null,
"address_district": null,
"address_number": null,
"address_state": null,
"address_street": null,
"address_zip": null,
"city_code": null,
"createdAt": "2026-09-01T09:00:00.000Z",
"document": "12345678000190",
"document_type": "cnpj",
"email": "contato@alfa.com.br",
"municipal_inscription": null,
"notes": null,
"phone": "1133334444",
"profile_id": "5b2c1e0a-7d3f-4c8e-9a1b-2f6d8e4c7a90",
"updatedAt": "2026-09-15T14:32:10.000Z",
"user_id": null
}
]{
"message": "Credenciais de API inválidas",
"statusCode": 401,
"error": "Unauthorized"
}{
"message": "Credenciais de API inválidas",
"statusCode": 401,
"error": "Unauthorized"
}{
"message": "Credenciais de API inválidas",
"statusCode": 401,
"error": "Unauthorized"
}Authorizations
HTTP Basic com o token como usuário e o secret como senha: curl -u dpz_tk_…:dpz_sk_…. Crie a chave em https://despezzas.com/settings/api-keys.
Query Parameters
Busca por nome/documento.
"mercado"
Tipo.
customer, supplier, both, partner "customer"
Response
Sucesso.
Quem cadastrou.
"0d6b923c-3392-424e-a152-2ee32474e8d5"
Id do contato.
"f1e2d3c4-b5a6-4978-8a9b-0c1d2e3f4a5b"
Nome.
"Distribuidora Alfa"
Tipo.
customer, supplier, both, partner "supplier"
Cidade.
null
Complemento.
null
Bairro.
null
Número.
null
UF.
null
Logradouro.
null
CEP.
null
Código IBGE do município (NFS-e).
null
Criação.
"2026-09-01T09:00:00.000Z"
CPF/CNPJ (só dígitos).
"12345678000190"
Tipo do documento (derivado).
cpf, cnpj, null "cnpj"
E-mail.
"contato@alfa.com.br"
Inscrição municipal (NFS-e).
null
Observações.
null
Telefone.
"1133334444"
Empresa (perfil de acesso).
"5b2c1e0a-7d3f-4c8e-9a1b-2f6d8e4c7a90"
Última alteração.
"2026-09-15T14:32:10.000Z"
Dono (contexto pessoal).
null