# Citi Beneficiary Validation API

**Canonical:** https://apis.io/apis/citi/citi-beneficiary-validation-api/  
**Provider:** Citi — https://apis.io/providers/citi/  
**Base URL:** https://tts.apib2b.citi.com/citiconnect/prod  
**Documentation:** https://developer.citi.com/apidocs/authentication/authentication-only-guide

Citi Beneficiary Validation API is one of 104 APIs that [Citi](https://apis.io/providers/citi/) publishes on the [APIs.io](https://apis.io/) network, described by a machine-readable OpenAPI specification. Tagged areas include Beneficiary Validation. The published artifact set on APIs.io includes an OpenAPI specification, API documentation, an API reference, and authentication docs.

Before initiating payment, POST beneficiary validation details to confirm that you are sending to the correct beneficiary. Validating beneficiary information is a two-step process: 1. Make a POST request to the `/paymentservices/v1/beneficiaryvalidations` endpoint and include the required information inside the payload of the request to initiate the transaction.<br/><br/> You will receive an initial response, usually within 5 seconds, verifying that your request was received and indicating whether it was accepted. If your request was not accepted, check the request and resubmit it. 2. When you receive the response to your POST request, retrieve the beneficiary details by making a GET request to the `/paymentservices/v1/beneficiaryvalidations/UETR`value endpoint, using the UETR value from your initial response.

## Operations (3)

| Method | Path | Summary |
|---|---|---|
| POST | `/paymentservices/v1/beneficiaryvalidations` | Validating the beneficiary account details |
| GET | `/paymentservices/v1/beneficiaryvalidations/{uetr}` | Inquire for the latest status of a beneficiary validation using UETR |
| GET | `/payment/beneficiarysearch` | Retrieve the Beneficiary details for a given debit and credit account number of… |

## Machine-readable artifacts (31)

- **OpenAPI** — https://raw.githubusercontent.com/api-evangelist/citi/refs/heads/main/openapi/citi-beneficiary-validation-api-openapi.yml
- **Documentation** — https://developer.citi.com/apidocs/authentication/authentication-only-guide
- **APIReference** — https://developer.citi.com/apidocs/authentication/authentication-api-reference
- **Authentication** — https://raw.githubusercontent.com/api-evangelist/citi/refs/heads/main/authentication/citi-authentication.yml
- **Conventions** — https://raw.githubusercontent.com/api-evangelist/citi/refs/heads/main/conventions/citi-conventions.yml
- **ErrorCatalog** — https://raw.githubusercontent.com/api-evangelist/citi/refs/heads/main/errors/citi-problem-types.yml
- **Sandbox** — https://raw.githubusercontent.com/api-evangelist/citi/refs/heads/main/sandbox/citi-sandbox.yml
- **Documentation** — https://developer.citi.com/apidocs/account-reporting/balances/balances-overview
- **APIReference** — https://developer.citi.com/apidocs/account-reporting/balances/balances-api-reference
- **Documentation** — https://developer.citi.com/apidocs/outgoing-payments/payments/payments-overview
- **APIReference** — https://developer.citi.com/apidocs/outgoing-payments/payments/payments-api-reference
- **Webhooks** — https://raw.githubusercontent.com/api-evangelist/citi/refs/heads/main/asyncapi/citi-webhooks.yml
- **DeclineCodes** — https://raw.githubusercontent.com/api-evangelist/citi/refs/heads/main/errors/citi-decline-codes.yml
- **Documentation** — https://developer.citi.com/apidocs/accept-payments/online-payment-acceptance/online-payment-acceptance-overview
- **APIReference** — https://developer.citi.com/apidocs/accept-payments/online-payment-acceptance/online-payment-acceptance-api-reference
- **Documentation** — https://developer.citi.com/apidocs/commercial-cards/virtual-cards/commercial-cards-overview
- **APIReference** — https://developer.citi.com/apidocs/commercial-cards/virtual-cards/virtual-cards-api-reference
- **Documentation** — https://developer.citi.com/apidocs/fx/gateway/citifx-gateway-overview
- **APIReference** — https://developer.citi.com/apidocs/fx/instant-fx/instant-fx-overview
- **Documentation** — https://developer.citi.com/apidocs/custody/accounts/accounts-overview
- **APIReference** — https://developer.citi.com/apidocs/custody/safekeeping-positions/safekeeping-positions-api-reference
- **Documentation** — https://developer.citi.com/apidocs/transfer-agency/accounts/accounts-overview
- **APIReference** — https://developer.citi.com/apidocs/transfer-agency/accounts/accounts-api-reference
- **Documentation** — https://developer.citi.com/apidocs/open-banking/ukraine-open-banking/ukraine-open-banking-overview
- **APIReference** — https://developer.citi.com/apidocs/open-banking/ukraine-open-banking/ukraine-bank-data-sharing-api-reference
- **Documentation** — https://developer.citi.com/apidocs/trade/standby-letters-of-credit/trade-overview
- **APIReference** — https://developer.citi.com/apidocs/trade/standby-letters-of-credit/trade-api-reference
- **Documentation** — https://developer.citi.com/apidocs/gateway-services/gateway-services-user-guide
- **APIReference** — https://developer.citi.com/apidocs/gateway-services/gateway-services-api-reference
- **Documentation** — https://developer.citi.com/apidocs/additional-payment-services/additional-payment-services/additional-payment-services-overview
- **APIReference** — https://developer.citi.com/apidocs/additional-payment-services/additional-payment-services/additional-payment-services-api-reference

## Other Citi APIs (12)

- [Citi Account Notification API](https://apis.io/apis/citi/citi-account-notification-api/)
- [Citi Accounts API](https://apis.io/apis/citi/citi-accounts-api/)
- [Citi Addonservices API](https://apis.io/apis/citi/citi-addonservices-api/)
- [Citi Authentication API](https://apis.io/apis/citi/citi-authentication-api/)
- [Citi Authenticationservices API](https://apis.io/apis/citi/citi-authenticationservices-api/)
- [Citi Authorization API](https://apis.io/apis/citi/citi-authorization-api/)
- [Citi Balance API](https://apis.io/apis/citi/citi-balance-api/)
- [Citi Bank Data Sharing API](https://apis.io/apis/citi/citi-bankdatasharing-api/)
- [Citi Billing API](https://apis.io/apis/citi/citi-billing-api/)
- [Citi Blocks & Filters API](https://apis.io/apis/citi/citi-blocks-filters-api/)
- [Citi Branch API](https://apis.io/apis/citi/citi-branch-api/)
- [Citi Cancel API](https://apis.io/apis/citi/citi-cancel-api/)

## Tags

Beneficiary Validation

---

Profiled by [API Evangelist](https://apievangelist.com) and published on [APIs.io](https://apis.io/apis/citi/citi-beneficiary-validation-api/). The API's provider profile, Kin Score and agent-readiness rating are at https://apis.io/providers/citi/.