Listar notas fiscais
curl --request GET \
--url https://api.despezzas.com/v2/business/invoices \
--header 'Authorization: Basic <encoded-value>'const options = {method: 'GET', headers: {Authorization: 'Basic <encoded-value>'}};
fetch('https://api.despezzas.com/v2/business/invoices', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));import requests
url = "https://api.despezzas.com/v2/business/invoices"
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/invoices"
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))
}{
"invoices": [
{
"amount": 150000,
"company_id": "9c7e5f31-2a4b-4d8c-b6e1-3f5a7c9e1b2d",
"id": "c3d4e5f6-a7b8-4c9d-8e0f-1a2b3c4d5e6f",
"provider": "asaas",
"service_description": "Consultoria financeira",
"status": "issued",
"batch_id": null,
"charge_id": "b2c3d4e5-f6a7-4b8c-8d9e-0f1a2b3c4d5e",
"contact_id": "f1e2d3c4-b5a6-4978-8a9b-0c1d2e3f4a5b",
"createdAt": "2026-09-01T09:00:00.000Z",
"created_by_user_id": "0d6b923c-3392-424e-a152-2ee32474e8d5",
"error_message": null,
"iss_amount": 3000,
"iss_rate": 2,
"issued_at": "2026-09-15T14:32:10.000Z",
"number": "2026/000123",
"pdf_url": "https://www.asaas.com/nfse/abc.pdf",
"profile_id": "5b2c1e0a-7d3f-4c8e-9a1b-2f6d8e4c7a90",
"transaction_id": "8f1c2a34-5b6d-4e7f-8a9b-0c1d2e3f4a5b",
"updatedAt": "2026-09-15T14:32:10.000Z",
"verification_code": "A1B2C3",
"xml_url": 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"
}Despezzas Business
Listar notas fiscais
Escopo necessário: read.
GET
/
v2
/
business
/
invoices
Listar notas fiscais
curl --request GET \
--url https://api.despezzas.com/v2/business/invoices \
--header 'Authorization: Basic <encoded-value>'const options = {method: 'GET', headers: {Authorization: 'Basic <encoded-value>'}};
fetch('https://api.despezzas.com/v2/business/invoices', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));import requests
url = "https://api.despezzas.com/v2/business/invoices"
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/invoices"
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))
}{
"invoices": [
{
"amount": 150000,
"company_id": "9c7e5f31-2a4b-4d8c-b6e1-3f5a7c9e1b2d",
"id": "c3d4e5f6-a7b8-4c9d-8e0f-1a2b3c4d5e6f",
"provider": "asaas",
"service_description": "Consultoria financeira",
"status": "issued",
"batch_id": null,
"charge_id": "b2c3d4e5-f6a7-4b8c-8d9e-0f1a2b3c4d5e",
"contact_id": "f1e2d3c4-b5a6-4978-8a9b-0c1d2e3f4a5b",
"createdAt": "2026-09-01T09:00:00.000Z",
"created_by_user_id": "0d6b923c-3392-424e-a152-2ee32474e8d5",
"error_message": null,
"iss_amount": 3000,
"iss_rate": 2,
"issued_at": "2026-09-15T14:32:10.000Z",
"number": "2026/000123",
"pdf_url": "https://www.asaas.com/nfse/abc.pdf",
"profile_id": "5b2c1e0a-7d3f-4c8e-9a1b-2f6d8e4c7a90",
"transaction_id": "8f1c2a34-5b6d-4e7f-8a9b-0c1d2e3f4a5b",
"updatedAt": "2026-09-15T14:32:10.000Z",
"verification_code": "A1B2C3",
"xml_url": 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
basicAuthapiSecret & apiToken
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
Status.
Available options:
queued, processing, issued, canceled, error Example:
"queued"
Tomador.
Example:
"f1e2d3c4-b5a6-4978-8a9b-0c1d2e3f4a5b"
Lote.
Response
Sucesso.
Notas fiscais de serviço (NFS-e).
Show child attributes
Show child attributes