# Citi Gateway Services API

**Canonical:** https://apis.io/apis/citi/citi-gateway-services-api/  
**Provider:** Citi — https://apis.io/providers/citi/  
**Base URL:** https://b2b.api.icg.citi.com/citiconnect/prod/gatewayservices  
**Documentation:** https://developer.citi.com/apidocs/gateway-services/gateway-services-user-guide

Citi Gateway Services API is one of 12 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 Platform and Administration. The published artifact set on APIs.io includes API documentation, an API reference, an OpenAPI specification, and authentication docs.

Marketplace and gateway management for CitiConnect: onboarding, entitlement and configuration operations used to administer a client's API estate. Citi publishes 1 machine-readable specification for this family covering 19 operations, served from developer.citi.com.

## Operations (19)

| Method | Path | Summary |
|---|---|---|
| POST | `/merchants/v1/onboard` | Create merchant |
| GET | `/merchants/v1/onboard` | Get Merchant ID |
| POST | `/merchants/v1/documents/upload` | Documents upload for verification |
| POST | `/merchants/v1/documents/download` | File Download |
| POST | `/merchants/v1/certification` | Submit Certification |
| GET | `/merchants/v1/certification` | Get Certification |
| POST | `/merchants/v1/wallets/activation` | Activate wallet for virtual accounts |
| GET | `/merchants/v1/wallets/balances` | Get wallet balances |
| GET | `/merchants/v1/wallets` | Get wallet status |
| POST | `/merchants/v1/link-accounts` | Link external account for payments |
| GET | `/merchants/v1/link-accounts` | Get linked account details |
| POST | `/merchants/v1/fx-rate` | FX Query |
| POST | `/merchants/v1/payments` | Create Payment |
| GET | `/merchants/v1/payments` | Get Payment |
| POST | `/merchants/v1/rfi` | RFI Response |
| GET | `/merchants/v1/rfi` | RFI Query |
| POST | `/merchants/v1/rfi/submit` | RFI Submit |
| GET | `/merchants/v1/transactions` | Transaction Reporting |
| GET | `/merchants/v1/balance-report` | Balance Report |

## Machine-readable artifacts (8)

- **Documentation** — https://developer.citi.com/apidocs/gateway-services/gateway-services-user-guide
- **APIReference** — https://developer.citi.com/apidocs/gateway-services/gateway-services-api-reference
- **OpenAPI** — https://raw.githubusercontent.com/api-evangelist/citi/refs/heads/main/openapi/citi-marketplace-management-openapi.yaml
- **Overlay** — https://raw.githubusercontent.com/api-evangelist/citi/refs/heads/main/overlays/citi-gateway-services-overlay.yaml
- **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

## Other Citi APIs (11)

- [Citi API Authentication Services](https://apis.io/apis/citi/citi-api-authentication-services/)
- [Citi Account Reporting APIs](https://apis.io/apis/citi/citi-account-reporting-apis/)
- [Citi Outgoing Payments APIs](https://apis.io/apis/citi/citi-outgoing-payments-apis/)
- [Citi Payment Acceptance APIs](https://apis.io/apis/citi/citi-payment-acceptance-apis/)
- [Citi Commercial Cards and Virtual Card Accounts APIs](https://apis.io/apis/citi/citi-commercial-cards-and-virtual-card-accounts-apis/)
- [CitiFX Gateway and Instant FX APIs](https://apis.io/apis/citi/citifx-gateway-and-instant-fx-apis/)
- [Citi Custody and Securities Services APIs](https://apis.io/apis/citi/citi-custody-and-securities-services-apis/)
- [Citi Funds Transfer Agency APIs](https://apis.io/apis/citi/citi-funds-transfer-agency-apis/)
- [Citi Open Banking APIs](https://apis.io/apis/citi/citi-open-banking-apis/)
- [CitiConnect Trade Services APIs](https://apis.io/apis/citi/citiconnect-trade-services-apis/)
- [Citi Additional Payment Services APIs](https://apis.io/apis/citi/citi-additional-payment-services-apis/)

## Tags

Platform, Administration

---

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