Added
Recipient Nationality and Date of Birth
about 1 month ago
POST /recipients and PATCH /recipients/{identifier} now accept two optional fields: nationality, a three-letter ISO 3166-1 alpha-3 country code (for example ARE, GBR), and date_of_birth, in YYYY-MM-DD format. Both are returned on every recipient response (GET /recipients, GET /recipients/{identifier}, and the create/update responses), and are null when not supplied. Supplying them upfront means we no longer need to request beneficiary details separately before processing a payout. A date_of_birth in the future or a nationality that is not a valid alpha-3 code returns 422 VALIDATION_ERROR.