curl --request GET \
  --url https://api.sandbox.z2pay.com/v1/recipients/{id} \
  --header 'x-api-key: <api-key>'

const options = {method: 'GET', headers: {'x-api-key': '<api-key>'}};

fetch('https://api.sandbox.z2pay.com/v1/recipients/{id}', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

import requests

url = "https://api.sandbox.z2pay.com/v1/recipients/{id}"

headers = {"x-api-key": "<api-key>"}

response = requests.get(url, headers=headers)

print(response.text)

{
  "id": "rec_gk1o75xv3ioi4eoqosorz9s62",
  "accountName": "Loja do Joao",
  "name": "Joao da Silva",
  "email": "joao.silva@example.com",
  "phone": "+5511987654321",
  "document": "12345678901",
  "type": "individual",
  "companyType": null,
  "companyLegalName": null,
  "companyFoundingDate": null,
  "annualRevenue": null,
  "corporationType": null,
  "birthDate": "1990-04-12T00:00:00.000Z",
  "motherName": "Maria da Silva",
  "profession": "Comerciante",
  "monthlyIncome": 850000,
  "legalRepresentativeInfo": null,
  "pixKeyType": "email",
  "pixKey": "joao.silva@example.com",
  "website": "https://lojadojoao.com.br",
  "mainAddress": {
    "id": "radr_n5t8wqz2mxk9rpf4hc7ydv3bj",
    "recipientId": "rec_gk1o75xv3ioi4eoqosorz9s62",
    "address": "Rua das Flores",
    "number": "123",
    "complement": "Apto 45",
    "neighborhood": "Centro",
    "city": "Sao Paulo",
    "state": "SP",
    "postalCode": "01001000",
    "referencePoint": null,
    "isMain": true,
    "isActive": true
  },
  "defaultBankAccount": {
    "id": "rba_bg9eddocogegc2pbjyexzd104",
    "recipientId": "rec_gk1o75xv3ioi4eoqosorz9s62",
    "status": "active",
    "bankHolderName": "Joao da Silva",
    "bankHolderDocument": "12345678901",
    "bankHolderType": "individual",
    "bankCode": "341",
    "bankName": "Itau Unibanco",
    "bankAgency": "1234",
    "bankAccount": "567890",
    "bankAccountDigit": "1",
    "bankAccountType": "checking"
  },
  "documents": [],
  "role": "seller",
  "status": "active",
  "splitValue": 10,
  "splitType": "percentage",
  "pixAntecipationDays": null,
  "bankSlipAntecipationDays": null,
  "creditCardAntecipationDays": null,
  "approvedAt": "2025-06-20T14:30:00.000Z",
  "refusedAt": null,
  "analysisComplete": true,
  "pendencies": [],
  "pendenciesSummary": {
    "open": 0,
    "blocking": 0,
    "warning": 0
  },
  "createdAt": "2025-06-18T09:15:00.000Z",
  "updatedAt": "2025-06-20T14:30:00.000Z"
}

{
  "error": {
    "code": "VALIDATION_ERROR",
    "message": "Validation failed",
    "issues": [
      {
        "path": "status",
        "message": "Status inválido. Valores aceitos: pending, waiting_payment, paid, refused, canceled, refunded"
      },
      {
        "path": "startDate",
        "message": "Data deve ser ISO 8601 com timezone (ex.: 2026-06-24T00:00:00Z)"
      }
    ]
  }
}

{
  "error": {
    "code": "UNAUTHORIZED",
    "message": "Invalid API key"
  }
}

{
  "error": {
    "code": "NOT_FOUND",
    "message": "Recipient not found"
  }
}