curl --request POST \
  --url https://api.sandbox.z2pay.com/v1/recipients \
  --header 'Content-Type: application/json' \
  --header 'x-api-key: <api-key>' \
  --data '
{
  "name": "<string>",
  "email": "jsmith@example.com",
  "document": "<string>",
  "phone": "<string>",
  "companyType": "<string>",
  "companyLegalName": "<string>",
  "companyFoundingDate": "<string>",
  "annualRevenue": 50000000000000,
  "corporationType": "<string>",
  "birthDate": "<string>",
  "motherName": "<string>",
  "profession": "<string>",
  "monthlyIncome": 50000000000000,
  "legalRepresentativeInfo": {
    "name": "<string>",
    "document": "<string>",
    "email": "jsmith@example.com",
    "motherName": "<string>",
    "birthdate": "<string>",
    "monthlyIncome": 50000000000000,
    "profession": "<string>",
    "phone": "<string>",
    "selfDeclaredRepresentative": true
  },
  "pixKeyType": "<string>",
  "pixKey": "<string>",
  "website": "<string>",
  "address": {
    "address": "<string>",
    "number": "<string>",
    "complement": "<string>",
    "neighborhood": "<string>",
    "city": "<string>",
    "state": "<string>",
    "postalCode": "<string>",
    "referencePoint": "<string>"
  },
  "files": {
    "identificationDocument": "<string>",
    "selfie": "<string>",
    "addressProof": "<string>",
    "socialContract": "<string>",
    "powerOfAttorney": "<string>"
  }
}
'

const options = {
  method: 'POST',
  headers: {'x-api-key': '<api-key>', 'Content-Type': 'application/json'},
  body: JSON.stringify({
    name: '<string>',
    email: 'jsmith@example.com',
    document: '<string>',
    phone: '<string>',
    companyType: '<string>',
    companyLegalName: '<string>',
    companyFoundingDate: '<string>',
    annualRevenue: 50000000000000,
    corporationType: '<string>',
    birthDate: '<string>',
    motherName: '<string>',
    profession: '<string>',
    monthlyIncome: 50000000000000,
    legalRepresentativeInfo: {
      name: '<string>',
      document: '<string>',
      email: 'jsmith@example.com',
      motherName: '<string>',
      birthdate: '<string>',
      monthlyIncome: 50000000000000,
      profession: '<string>',
      phone: '<string>',
      selfDeclaredRepresentative: true
    },
    pixKeyType: '<string>',
    pixKey: '<string>',
    website: '<string>',
    address: {
      address: '<string>',
      number: '<string>',
      complement: '<string>',
      neighborhood: '<string>',
      city: '<string>',
      state: '<string>',
      postalCode: '<string>',
      referencePoint: '<string>'
    },
    files: {
      identificationDocument: '<string>',
      selfie: '<string>',
      addressProof: '<string>',
      socialContract: '<string>',
      powerOfAttorney: '<string>'
    }
  })
};

fetch('https://api.sandbox.z2pay.com/v1/recipients', 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"

payload = {
    "name": "<string>",
    "email": "jsmith@example.com",
    "document": "<string>",
    "phone": "<string>",
    "companyType": "<string>",
    "companyLegalName": "<string>",
    "companyFoundingDate": "<string>",
    "annualRevenue": 50000000000000,
    "corporationType": "<string>",
    "birthDate": "<string>",
    "motherName": "<string>",
    "profession": "<string>",
    "monthlyIncome": 50000000000000,
    "legalRepresentativeInfo": {
        "name": "<string>",
        "document": "<string>",
        "email": "jsmith@example.com",
        "motherName": "<string>",
        "birthdate": "<string>",
        "monthlyIncome": 50000000000000,
        "profession": "<string>",
        "phone": "<string>",
        "selfDeclaredRepresentative": True
    },
    "pixKeyType": "<string>",
    "pixKey": "<string>",
    "website": "<string>",
    "address": {
        "address": "<string>",
        "number": "<string>",
        "complement": "<string>",
        "neighborhood": "<string>",
        "city": "<string>",
        "state": "<string>",
        "postalCode": "<string>",
        "referencePoint": "<string>"
    },
    "files": {
        "identificationDocument": "<string>",
        "selfie": "<string>",
        "addressProof": "<string>",
        "socialContract": "<string>",
        "powerOfAttorney": "<string>"
    }
}
headers = {
    "x-api-key": "<api-key>",
    "Content-Type": "application/json"
}

response = requests.post(url, json=payload, headers=headers)

print(response.text)

{
  "id": "rec_gk1o75xv3ioi4eoqosorz9s62",
  "accountName": null,
  "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": null,
  "motherName": null,
  "profession": null,
  "monthlyIncome": null,
  "legalRepresentativeInfo": null,
  "pixKeyType": null,
  "pixKey": null,
  "website": null,
  "mainAddress": null,
  "defaultBankAccount": null,
  "role": "seller",
  "status": "new",
  "splitValue": null,
  "splitType": null,
  "pixAntecipationDays": null,
  "bankSlipAntecipationDays": null,
  "creditCardAntecipationDays": null,
  "approvedAt": null,
  "refusedAt": null,
  "analysisComplete": false,
  "pendencies": [],
  "pendenciesSummary": {
    "open": 0,
    "blocking": 0,
    "warning": 0
  },
  "createdAt": "2025-06-29T13:45:30.000Z",
  "updatedAt": "2025-06-29T13:45:30.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": "A request with this idempotency key is already being processed"
}

{
  "error": "Idempotency key already used with a different request body"
}