Transfers addressed to a person of your team
The tax ID transfer now publishes recipient_member, the team member it is addressed to, and nif_transfer_invalid gains the subcode own_account. Four updated operations and four updated MCP tools.
9 November 2026 — The web app can now offer a tax ID transfer to a person of
your own team, who opens a new account with the company and pays for it. Such a
transfer has no secret, so a recipient_account_id of null no longer means that
anyone holding the secret can accept it. The API now says who the transfer is
addressed to.
recipient_member— The transfer returned byGET /v1/accounts/{account}/nif-transfers,POST /v1/accounts/{account}/nif-transfers,POST /v1/accounts/{account}/nif-transfers/acceptandPOST /v1/accounts/{account}/nif-transfers/{nif_transfer}/revokeincludesrecipient_member:{ "id": … }with the identifier of the person it is addressed to, ornull. It is never set together withrecipient_account_id. The API does not issue transfers to a person, so the ones you issue always returnnull. You can revoke a transfer to a person like any other.own_account— Accepting a transfer from the account that issued it answers422 nif_transfer_invalidwitherror.subcodeown_accountanderror.paramsecret, and the message asks you to accept it from another account. Every other case ofnif_transfer_invalidstill comes without a subcode.- MCP tools —
list_nif_transfers,create_nif_transfer,accept_nif_transferandrevoke_nif_transferreturn the same field and the same subcode.
The change is additive and your integration keeps working. If you read
recipient_account_id: null as «whoever has the secret can accept it», check
recipient_member as well. The new options of the app are in
Tax ID transfers in the app.
Updated endpoints4
| Endpoint | Description |
|---|---|
GET/v1/accounts/{account}/nif-transfers | List issued tax ID transfers |
POST/v1/accounts/{account}/nif-transfers | Issue a tax ID transfer |
POST/v1/accounts/{account}/nif-transfers/accept | Accept a tax ID transfer |
POST/v1/accounts/{account}/nif-transfers/{nif_transfer}/revoke | Revoke a tax ID transfer |