Citi website screenshot

Citi

Citi is the consumer and institutional brand of Citigroup, serving over 200 million customers across 160 countries. Citi runs one of the largest published API estates in banking: 118 machine-readable OpenAPI and Swagger contracts covering 297 operations are served from developer.citi.com across payment initiation and status, payment acceptance and collections, account reporting and statements, commercial cards and virtual card accounts, CitiFX Gateway and Instant FX, custody and securities services, funds transfer agency, trade services, open banking and gateway services. The payment estate is ISO 20022 native: pain.001, pacs.008, pacs.009 and camt.056 message types are declared inside the contracts themselves, in matched JSON and XML encodings. Authentication is OAuth 2.0 client-credentials over mutual TLS with message-level PKI signing. A sandbox estate is declared in the contracts; production access is relationship-managed through Citi sales.

Citi publishes 104 API contracts indexed on the APIs.io network, including Account Notification API, Accounts API, Addonservices API, and 101 more. Tagged areas include Banking, Financial Services, Open Banking, Payments, and Treasury.

The Citi catalog on APIs.io includes 1 event-driven AsyncAPI specification, 1 JSON-LD context, and 1 Spectral governance ruleset.

Citi’s developer surface includes developer portal, documentation, API reference, getting-started guide, signup flow, support, engineering blog, and 45 more developer resources.

🌐 Visit website📡 Profile data on GitHub
61.4/100 strong ▬ flat Agent 54/100 agent native Full breakdown ↓
scored 2026-10-17 · rubric v0.24.0
196 published contracts 1 MCP Servers
BankingFinancial ServicesOpen BankingPaymentsTreasuryISO 20022Commercial CardsForeign ExchangeCustodyTrade FinanceCorporate BankingAPI Gateway

What this lets a business do 1

Business capabilities this provider's published APIs can perform, derived from its own contracts. Browse all capabilities →

Treasury Management
BC-210
Contract status inquiryFxgatewayWorldLink Cancel FXWorldLink v3Worldlinkservices
POST /worldlinkservices/v5/fx/bookfx POST /worldlinkservices/v5/fx/raterequest POST /v1/fx/cancelfx POST /v3/payment/initiation

Kin Score

Kin Score Kin Score How this is scored →
scored 2026-10-17 · rubric v0.24.0
Composite quality — 61.4/100 · strong
Contract Quality 14.1 / 19
Developer Ergonomics 9.9 / 15
Access Clarity 6.3 / 15
Operational Transparency 2.8 / 10
Contract Governance 2.0 / 9
Discoverability 5.4 / 8
Regulatory Posture 8.4 / 15
Create-or-Update Ergonomics 2.8 / 10
Agent readiness — 54/100 · agent native
Machine-Readable Contract 18 / 18
Agentic Access Contract 10 / 10
Documented Reversibility 6 / 6
MCP Server 0 / 12
Machine-Readable Auth 10 / 10
Idempotency 9 / 9
Stable Error Semantics 8 / 8
Request/Response Examples 7 / 7
Rate-Limit Signaling 7 / 7
Typed Event Surface 6 / 6
Agent Skills 5 / 5
Well-Known Catalog 0 / 4
Consent & Bot Identity 0 / 3
A2A Agent Card 0 / 8
Dry-Run / Simulate Mode 0 / 4
Delegated User Identity 6 / 6
Protected Resource Metadata 0 / 5
Registration Without a Human 0 / 6
Agentic Commerce Well-Known Document 0 / 5
Regulatory Posture applies to this provider. Its tags matched the Banking & Open Finance regime, so Regulatory Posture carries 15 points of the composite. If this regime is wrong for your business, say so on your provider repo — the applicability map is public and we will correct it.
Create-or-Update Ergonomics applies to this provider. This API accepts writes, so it carries 10 points of the composite. It is scored from the published contracts themselves: whether a caller can create-or-update in one call, whether the write accepts a key the caller already holds, and whether the response says which branch ran. Without that, every write needs a search-and-branch in front of it, and the first time that check is skipped a duplicate record is created. Scored against the observed mean rather than raw — a provider at the catalog average is unchanged by this facet, not penalised by it.
The six quality facets above are damped to 75 points between them, because the conditional facet above carries the other 25. That is why each facet's contribution is shown against a damped maximum: raising a quality facet moves the composite by 75% of its nominal weight, not 100%. The full arithmetic is at apis.io/rating/.
Improve this rating by publishing the missing artifacts — every area above can be raised, and the full rubric is at apis.io/rating/. Every facet and dimension name above is a link: it opens that measurement's own page — what it means, the exact checks that feed it, how the whole catalog distributes on it, and the providers at the top of it. This rating is computed from github.com/api-evangelist/citi: open an issue to ask a question, or submit a pull request to add artifacts. Submit an artifact on GitHub — free → Manage your own listing — the Influence plan, $499/mo →

Markets this provider is in provisional

The Kin Score Market layer reads a provider inside its market: its position, and how deep its integrations go. Depth is only comparable within a position. Provisional and unweighted: not part of the Kin Score or agent readiness.

MarketPositionDepthRegistered MCP serverDeclares compatibility
Open Banking standard 53.7 - -
US Open Banking (FDX) standard 53.7 - -

Registered MCP server and declares compatibility are report only — not weighted. Undeclared means we found nothing we can read, so there is no number: we never infer integrations.

Standards implemented 1

Standards this provider implements or carries. De facto ones are profiled and measured by the API Commons; formal ones come from the standards directory and are linked by the provider's own tags. The evidence column says how each claim was established — not that it was made.

ISO 20022
tagged — the provider's own APIs.json carries the standard as a tag; implementation not verified

APIs 104

Individual APIs this provider publishes, each with its own machine-readable definition.

Citi Account Notification API

The Account Notification API from Citi — 1 operation(s) for account notification.

Citi Accounts API

The Accounts API from Citi — 6 operation(s) for accounts.

Citi Addonservices API

The Addonservices API from Citi — 1 operation(s) for addonservices.

Citi Authentication API

The Authentication API from Citi — 3 operation(s) for authentication.

Citi Authenticationservices API

The Authenticationservices API from Citi — 4 operation(s) for authenticationservices.

Citi Authorization API

Dual Auth Authorization Request and Response

Citi Balance API

The Balance API from Citi — 1 operation(s) for balance.

Citi Bank Data Sharing API

API services to provide accounts, balances and transactions details.

Citi Beneficiary Validation API

Before initiating payment, POST beneficiary validation details to confirm that you are sending to the correct beneficiary. Validating beneficiary information is a two-step proce...

Citi Billing API

The Billing API from Citi — 6 operation(s) for billing.

Citi Blocks & Filters API

API services to provide Block & Filters in an account.

Citi Branch API

The Branch API from Citi — 1 operation(s) for branch.

Citi Cancel API

The Cancel API from Citi — 1 operation(s) for cancel.

Citi Certification API

KYC certification submission and retrieval

Citi Citiconnect API

The Citiconnect API from Citi — 2 operation(s) for citiconnect.

Citi Cob R API

Reúne endpoints destinados a lidar com gerenciamento de cobranças associadas a uma recorrência.

Citi Collection API

The Collection API from Citi — 4 operation(s) for collection.

Citi Contract status inquiry API

The Contract status inquiry API from Citi — 1 operation(s) for contract status inquiry.

Citi Create API

The Create API from Citi — 1 operation(s) for create.

Citi Create Dispute request API

Operations related to dispute management

Citi Digitalpayments API

The Digitalpayments API from Citi — 5 operation(s) for digitalpayments.

Citi Dispute webhook API

Webhook notification to be sent to clients for case status

Citi Document API

The Document API from Citi — 1 operation(s) for document.

Citi Emandateservices API

The Emandateservices API from Citi — 4 operation(s) for emandateservices.

Citi File API

File management

Citi Fx API

The Fx API from Citi — 2 operation(s) for fx.

Citi Fxgateway API

The Fxgateway API from Citi — 13 operation(s) for fxgateway.

Citi Fx Rate Inquiry API

API services to support FX Rate Inquiry

Citi Get Notifications API

Operations for retrieving VCA transaction notifications

Citi Get Vca Details API

The GetVcaDetails API from Citi — 1 operation(s) for getvcadetails.

Citi Holdings API

Operations related to Holdings

Citi Investors API

Operations related to Investors

Citi Ipscheme API

The Ipscheme API from Citi — 1 operation(s) for ipscheme.

Citi Link Account API

Account linkage operations for external payments

Citi Mandate API

Mandate API

Citi Mandates API

The Mandates API from Citi — 4 operation(s) for mandates.

Citi Merchant Creation API

Merchant onboarding and management operations

Citi Modify API

The Modify API from Citi — 1 operation(s) for modify.

Citi Mvca API

The Mvca API from Citi — 3 operation(s) for mvca.

Citi Non-Payment Messages API

The Non-Payment Messages API from Citi — 2 operation(s) for non-payment messages.

Citi Notification API

Dual Auth Notification Request Payload

Citi Pacs 00800108 API

The Pacs 00800108 API from Citi — 1 operation(s) for pacs 00800108.

Citi Pacs 00900108 API

The Pacs 00900108 API from Citi — 1 operation(s) for pacs 00900108.

Citi Payer ID Inquiry API

PayerID Inquiry API has an ability to Inquiry API has an ability to inquire statuses of a single payer ID or assignee ID.

Citi Payer ID Maintenance API

PayerID Maintenance API has an ability to activate PayerID.

Citi Payer ID Reservation API

PayerID Reservations API has an ability to reserve PayerID.

Citi Payer ID Update Accountsand Currencies API

PayerID Update accounts and currencies API has an ability to update accounts and currency details of the given Payer ID.

Citi Payer ID Update Assignee API

PayerID Update assignee API has an ability to update, add or remove assignee details of the given Payer ID.

Citi Payment Acceptance API

Payment Acceptance API

Citi Payment API

Payout and payment query operations

Citi Payment Order Consent API

APIs to TPP for payment order consent creation and inquiry.

Citi Payments API

Use the Payments endpoint to initiate and track instant payments. While all payments can be sent through a single CitiConnect API, it is important to observe local country requi...

Citi Pix API

reúne endpoints destinados a lidar com gerenciamento de Pix recebidos.

Citi Proof Of Payment API

APIs for retrieving proof of payment reports.

Citi Provisioning API

These are operations related to provisioning requests.

Citi Proxylookup API

The Proxylookup API from Citi — 1 operation(s) for proxylookup.

Citi Public Key API

The Public Key API from Citi — 1 operation(s) for public key.

Citi push Notifications API

Webhook push notification operations for authorized and clearing transactions

Citi Rec API

Reúne endpoints destinados a lidar com gerenciamento de recorrências.

Citi Refunds API

Refunds API

Citi Reporting API

Transaction and balance reporting operations

Citi Request for Information API

API services to support Request for Information

Citi Response to Request for Information API

API services to support Response to Request for Information

Citi Rfi API

Request for Information operations

Citi Services API

The Services API from Citi — 14 operation(s) for services.

Citi Sessions API

The Sessions API from Citi — 2 operation(s) for sessions.

Citi Solic Rec API

Reúne endpoints destinados a lidar com gerenciamento de solicitações de recorrências.

Citi Statement API

Statement

Citi Statement Services v1 API

Statement Services v1

Citi Status Enquiry request API

Operations related to dispute status enquiry

Citi Submit Action API

Operations related to ETF Order Approval processing

Citi Submit Plf API

Operations related to ETF basket processing

Citi Subscription API

Operations related to event subscriptions

Citi Token Lifecycle Events API

The Token Lifecycle Events API from Citi — 1 operation(s) for token lifecycle events.

Citi Token Provisioning Events API

The Token Provisioning Events API from Citi — 1 operation(s) for token provisioning events.

Citi Tokens API

Tokens API

Citi Trade API

The Trade API from Citi — 3 operation(s) for trade.

Citi Trade Finance Undertaking API

The Trade Finance Undertaking API from Citi — 2 operation(s) for trade finance undertaking.

Citi Transaction API

The Transaction API from Citi — 2 operation(s) for transaction.

Citi Transactions API

Operations related to Transactions

Citi Txrefund API

The Txrefund API from Citi — 1 operation(s) for txrefund.

Citi User Profile API

The User Profile API from Citi — 1 operation(s) for user profile.

Citi Validate API

The Validate API from Citi — 1 operation(s) for validate.

Citi Validations API

API services to support beneficiary/bank validation initiation

Citi Vca API

The Vca API from Citi — 9 operation(s) for vca.

Citi VCA Clearing Exception Report API

The VCA Clearing Exception Report API from Citi — 1 operation(s) for vca clearing exception report.

Citi Vca Create Notification Service API

The vca-create-notification-service API from Citi — 1 operation(s) for vca-create-notification-service.

Citi Virtual Account Single Entity API

Virtual Account Single Entity

Citi Virtual Account-Wallet API

The Virtual Account-Wallet API from Citi — 1 operation(s) for virtual account-wallet.

Citi Wallet API

Wallet management and balance operations

Citi Webhook API

Reúne endpoints para gerenciamento de notificações por parte do PSP recebedor ao usuário recebedor.

Citi Webhook Cob R API

Reúne endpoints para gerenciamento de notificações de cobranças recorrentes por parte do PSP recebedor ao usuário recebedor.

Citi Webhook Rec API

Reúne endpoints para gerenciamento de notificações de recorrências por parte do PSP recebedor ao usuário recebedor.

Citi Webhooks API

Operation related to webhook requests.

Citi WorldLink Cancel FX API

The WorldLink Cancel FX API from Citi — 1 operation(s) for worldlink cancel fx.

Citi WorldLink v2 API

The WorldLink v2 API from Citi — 3 operation(s) for worldlink v2.

Citi WorldLink v3 API

The WorldLink v3 API from Citi — 3 operation(s) for worldlink v3.

Citi Worldlinkservices API

The Worldlinkservices API from Citi — 2 operation(s) for worldlinkservices.

Citi Bulk Payments API

The Bulk Payments API from Citi — 1 operation(s) for bulk payments.

Citi Consent Management API

API services to create, retrieve, and delete account information consent.

Citi Direct Debits API

The Direct Debits API from Citi — 1 operation(s) for direct debits.

Citi Payment Services API

The Payment Services API from Citi — 5 operation(s) for payment services.

Citi Tax ID validation API

API to validate taxId status

Citi Virtual Card API

The Virtual Card API from Citi — 1 operation(s) for virtual card.

Scroll for all 104

MCP Servers 1

Model Context Protocol servers that expose these APIs to AI agents.

Citi MCP Server

MCP SERVER

Pricing Plans 1

Published pricing tiers and plan structures.

Citi Plans Pricing

0 plans

PLANS

Rate Limits 1

Documented rate limits and quota policies.

Citi Rate Limits

0 limits

RATE LIMITS

Event Specifications 1

AsyncAPI definitions for this provider's event-driven and streaming APIs.

Citi Webhooks

ASYNCAPI

Semantic Vocabularies 1

JSON-LD contexts and semantic vocabularies used across these APIs.

Citi Context

120 classes · 424 properties

JSON-LD

Spectral Rules 1

Spectral governance rulesets for linting and validating these APIs.

Citi API Rules

16 rules · 8 errors 7 warnings 1 info

SPECTRAL

OpenAPI Overlays 12

Overlays applied on top of this provider's contracts. Each card says who wrote it: a document the provider publishes, or one API Evangelist derived or generated.

Citi Accept Payments Overlay

5 actions · update

GENERATED

Citi Account Reporting Overlay

5 actions · update

GENERATED

Citi Additional Payment Services Overlay

5 actions · update

GENERATED

Citi Authentication Overlay

5 actions · update

GENERATED

Citi Commercial Cards Overlay

5 actions · update

GENERATED

Citi Custody Overlay

5 actions · update

GENERATED

Citi Fx Overlay

5 actions · update

GENERATED

Citi Gateway Services Overlay

5 actions · update

GENERATED

Citi Open Banking Overlay

5 actions · update

GENERATED

Citi Outgoing Payments Overlay

5 actions · update

GENERATED

Citi Trade Overlay

5 actions · update

GENERATED

Citi Transfer Agency Overlay

5 actions · update

GENERATED

Scroll for all 12

JSON Schema 117

Standalone JSON Schema definitions for this provider's data models.

3291fe1b-9d6f-4285-9836-a2c66ac1dbd3-json-response-schema

2 properties

JSON SCHEMA

a5ae4ee1-c9c8-4b1b-9437-8acdc6ac815c-json-response-schema

2 properties

JSON SCHEMA

AccountSummaryInboundRequest

1 properties

JSON SCHEMA

AccountsInformation

2 properties

JSON SCHEMA

AckResponsePayload

2 properties

JSON SCHEMA

AmendMandateDetails

5 properties

JSON SCHEMA

Authentication-Payer-Request

7 properties

JSON SCHEMA

Authentication Payer Response

7 properties

JSON SCHEMA

Authentication Request

4 properties

JSON SCHEMA

Authentication Response

4 properties

JSON SCHEMA

authorizationRequest

38 properties

JSON SCHEMA

authorizationResponse

1 properties

JSON SCHEMA

BalInquiryRequest

4 properties

JSON SCHEMA

BalInquiryResponse

6 properties

JSON SCHEMA

Balance Information

2 properties

JSON SCHEMA

BalanceInquiryResponse

1 properties

JSON SCHEMA

BalanceRequest

5 properties

JSON SCHEMA

BeneficiaryValidationRequest

5 properties

JSON SCHEMA

BeneficiaryValidationResponse

4 properties

JSON SCHEMA

bfd3c727-0034-4ac4-9905-b58ca4437cf2-json-response-schema

2 properties

JSON SCHEMA

Block And Filters Create Request

0 properties

JSON SCHEMA

Block and filters response

0 properties

JSON SCHEMA

Block and Filters response

0 properties

JSON SCHEMA

Pagination Metadata

4 properties

JSON SCHEMA

blocks response

3 properties

JSON SCHEMA

Block And Filters Update Request

0 properties

JSON SCHEMA

CancelVirtualCardRequest

4 properties

JSON SCHEMA

CancelVirtualCardResponse

3 properties

JSON SCHEMA

CardEnrollmentPartialSuccessResponse

4 properties

JSON SCHEMA

CardEnrollmentRequest

4 properties

JSON SCHEMA

CardEnrollmentSuccessResponse

4 properties

JSON SCHEMA

CardMaintenancePartialSuccessResponse

5 properties

JSON SCHEMA

CardMaintenanceRequest

6 properties

JSON SCHEMA

CardMaintenanceSuccessResponse

5 properties

JSON SCHEMA

CaseRequest

3 properties

JSON SCHEMA

CashAccount

10 properties

JSON SCHEMA

CertificationRequest

0 properties

JSON SCHEMA

Cobrança Recorrente Completa

0 properties

JSON SCHEMA

Cobrança Recorrente Gerada

0 properties

JSON SCHEMA

Cobranças recorrentes consultadas

2 properties

JSON SCHEMA

CreateVirtualCardRequest

37 properties

JSON SCHEMA

CreateVirtualCardResponse

39 properties

JSON SCHEMA

d3723b0b-c5b9-4306-854c-8d1e7bc59ed3-json-response-schema

2 properties

JSON SCHEMA

DisputeCaseStatusUpdate

4 properties

JSON SCHEMA

DocumentReq

1 properties

JSON SCHEMA

Document

1 properties

JSON SCHEMA

EntityIDRequest

3 properties

JSON SCHEMA

ExecutionReport_2

8 properties

JSON SCHEMA

ExecutionReport

8 properties

JSON SCHEMA

f733f311-c85c-4b66-a29e-64dec7d84753-json-response-schema

2 properties

JSON SCHEMA

febf0553-d455-4849-b6fa-2337b4989b0f-json-response-schema

2 properties

JSON SCHEMA

FileDownloadResponse

0 properties

JSON SCHEMA

FileUploadResponse

3 properties

JSON SCHEMA

FinalBeneficiaryValidationResponse

12 properties

JSON SCHEMA

FinalMessageResponse

5 properties

JSON SCHEMA

Fx-Deal-Inquiry-API-Response

1 properties

JSON SCHEMA

FxQueryRequest

0 properties

JSON SCHEMA

FxQueryResponse

0 properties

JSON SCHEMA

Fx-Rate-Response

5 properties

JSON SCHEMA

FXBenchMarkOrder

6 properties

JSON SCHEMA

FXBenchmarkOrder

6 properties

JSON SCHEMA

FXQuoteReportResponse

8 properties

JSON SCHEMA

FXQuoteResponse

8 properties

JSON SCHEMA

GetCertificationResponse

0 properties

JSON SCHEMA

GetInvestorAccountHoldingsResponse

2 properties

JSON SCHEMA

GetInvestorsResponse

2 properties

JSON SCHEMA

GetLinkAccountResponse

0 properties

JSON SCHEMA

GetMerchantOnboarding

0 properties

JSON SCHEMA

GetVcaDetailsInboundRequest

6 properties

JSON SCHEMA

GetVcaDetailsInboundResponse

32 properties

JSON SCHEMA

InitialAcknowledgementResponse

4 properties

JSON SCHEMA

InitialBeneficiaryValidationResponse

7 properties

JSON SCHEMA

InquiryMandateResponse

7 properties

JSON SCHEMA

Inquiry-Request

4 properties

JSON SCHEMA

Inquiry-Response

6 properties

JSON SCHEMA

LinkAccountRequest

4 properties

JSON SCHEMA

Mandate Cancellation Request

1 properties

JSON SCHEMA

MandateClientDetails

5 properties

JSON SCHEMA

mandate_full_details

4 properties

JSON SCHEMA

MandateInitiationRequest

1 properties

JSON SCHEMA

mandateInqResponse

0 properties

JSON SCHEMA

Mandate-Inquiry-Response

0 properties

JSON SCHEMA

mandate_response

1 properties

JSON SCHEMA

MerchantOnboardingRequest

0 properties

JSON SCHEMA

MerchantOnboardingResponse

2 properties

JSON SCHEMA

MessageRequest

2 properties

JSON SCHEMA

ModifyVirtualCardRequest

38 properties

JSON SCHEMA

ModifyVirtualCardResponse

37 properties

JSON SCHEMA

notificationRequest

42 properties

JSON SCHEMA

oAuthTokenRequest

5 properties

JSON SCHEMA

oAuthTokenRequest

5 properties

JSON SCHEMA

Pagination Metadata

4 properties

JSON SCHEMA

Payer-ID-Maintenance-Request

6 properties

JSON SCHEMA

Payer-ID-Reservation-Request

3 properties

JSON SCHEMA

Payer-ID-Update-Accounts-Request

2 properties

JSON SCHEMA

Payer-ID-Update-Assignee-Request

5 properties

JSON SCHEMA

Payment Notification

8 properties

JSON SCHEMA

PaymentRefundNotification

10 properties

JSON SCHEMA

PaymentRequest

5 properties

JSON SCHEMA

RecallMandate

2 properties

JSON SCHEMA

Refunds

5 properties

JSON SCHEMA

Request

2 properties

JSON SCHEMA

oAuthTokenResponse

1 properties

JSON SCHEMA

Response

4 properties

JSON SCHEMA

StatementTransactionsInboundRequest

5 properties

JSON SCHEMA

SubscriptionReqType

7 properties

JSON SCHEMA

SubscriptionResponse

1 properties

JSON SCHEMA

successResponsePayload

1 properties

JSON SCHEMA

SyncResponse

1 properties

JSON SCHEMA

oAuthTokenResponse

4 properties

JSON SCHEMA

oAuthTokenResponse

4 properties

JSON SCHEMA

Transaction Information

2 properties

JSON SCHEMA

TransactionRequest

7 properties

JSON SCHEMA

TransactionResponse

5 properties

JSON SCHEMA

UnbilledTransactionsInboundRequest

3 properties

JSON SCHEMA

UnbilledTransactionsInboundResponse

5 properties

JSON SCHEMA

UpdateMandateDetails

3 properties

JSON SCHEMA

Scroll for all 117

Security Posture 3

Authentication, domain security, vulnerability disclosure, and trust-center signals.

Citi Authentication

apiKey/http/oauth2/unknown · 10 schemes

SECURITY

Citi Domain Security

TLSv1.2 · HSTS · DMARC

SECURITY

Citi Vulnerability Disclosure

Bugcrowd

SECURITY

Scopes 1

OAuth scopes governing access to this provider's APIs.

Citi Scopes

24 scopes · clientCredentials/authorizationCode

24 scopes

SCOPES

Agentic Access 1

Recommended x-agentic-access execution contracts for AI agents.

Citi Agentic Access

273 operations · 174 acting · 1 human-in-the-loop

273 operations · 174 acting

AGENTIC

Resources

Get Started 6

Portal, sign-up, and the first successful call

DeveloperPortal
DeveloperPortal
 Portal
Portal
 GettingStarted
GettingStarted
 SignUp
SignUp
 Login
Login
 Sandbox
Sandbox

Documentation 3

Reference material describing how the API behaves

Documentation
Documentation
 APIReference
APIReference
 Documentation
Documentation

Agent Surfaces 3

MCP servers, agent skills, and machine-readable catalogs

AgenticAccess
AgenticAccess
 AgentSkill
AgentSkill
 MCPServer
MCPServer

Design & Contract 10

Pagination, idempotency, versioning, errors, and events

Spectral
Spectral
 JSONLD
JSONLD
 Vocabulary
Vocabulary
 Conventions
Conventions
 Idempotency
Idempotency
 Conformance
Conformance
 ErrorCatalog
ErrorCatalog
 Lifecycle
Lifecycle
 DataModel
DataModel
 Webhooks
Webhooks

Scroll for all 10

Build 2

SDKs, sample code, and the tooling you integrate with

GitHubOrganization
GitHubOrganization
 DeclineCodes
DeclineCodes

Access & Security 6

Authentication, authorization, and security posture

Authentication
Authentication
 OAuthScopes
OAuthScopes
 Compliance
Compliance
 DomainSecurity
DomainSecurity
 VulnerabilityDisclosure
VulnerabilityDisclosure
 Security
Security

Operate 2

Status, limits, changes, and where to get help

Support
Support
 Deprecation
Deprecation

Commercial 2

Pricing, plans, and the legal terms of use

TermsOfService
TermsOfService
 PrivacyPolicy
PrivacyPolicy

Company 3

The organization behind the API

Website
Website
 Blog
Blog
 LinkedIn
LinkedIn

Other 15

Properties that don't map to a standard resource type

Hosts
Hosts
 Vendors
Vendors
 CapabilityMap
CapabilityMap
 Overlay
Overlay
 Overlay
Overlay
 Overlay
Overlay
 Overlay
Overlay
 Overlay
Overlay
 Overlay
Overlay
 Overlay
Overlay
 Overlay
Overlay
 Overlay
Overlay
 Overlay
Overlay
 Overlay
Overlay
 Overlay
Overlay

Scroll for all 15

Source (apis.yml)

apis.yml Raw ↑ 
aid: citi
deliveryModel:
  model: unknown
  open_source: false
  commercial: false
  callable_host: false
  label: Delivery model not determined — needs a product licence on record
  confidence: low
  source:
  - none
  generated: '2026-08-28'
  method: derived
accessModel:
  pricing: unknown
  onboarding: unknown
  trial: false
  try_now: false
  public: false
  label: Unknown
  confidence: low
  source: []
  generated: '2026-07-22'
  method: derived
image: https://kinlane-images.s3.amazonaws.com/shared/apis-json/icons/citi.png
name: Citi
url: https://raw.githubusercontent.com/api-evangelist/citi/refs/heads/main/apis.yml
created: '2026-03-21'
modified: '2026-09-05'
kind: alias
access: 1st-Party
position: Producing
specificationVersion: '0.23'
aliasOf: citigroup
canonical:
  aid: citigroup
  url: https://raw.githubusercontent.com/api-evangelist/citigroup/refs/heads/main/apis.yml
tags:
- Banking
- Financial Services
- Open Banking
- Payments
- Treasury
- ISO 20022
- Commercial Cards
- Foreign Exchange
- Custody
- Trade Finance
- Corporate Banking
- API Gateway
tags_raw:
- Banking
- Financial Services
- Open Banking
- Payments
- Treasury
- ISO 20022
- Commercial Cards
- Foreign Exchange
- Custody
- Trade Finance
- Corporate Banking
- API Gateway
- Financial-Services
description: 'Citi is the consumer and institutional brand of Citigroup, serving over 200 million customers across 160 countries.
  Citi runs one of the largest published API estates in banking: 118 machine-readable OpenAPI and Swagger contracts covering
  297 operations are served from developer.citi.com across payment initiation and status, payment acceptance and collections,
  account reporting and statements, commercial cards and virtual card accounts, CitiFX Gateway and Instant FX, custody and
  securities services, funds transfer agency, trade services, open banking and gateway services. The payment estate is ISO
  20022 native: pain.001, pacs.008, pacs.009 and camt.056 message types are declared inside the contracts themselves, in matched
  JSON and XML encodings. Authentication is OAuth 2.0 client-credentials over mutual TLS with message-level PKI signing. A
  sandbox estate is declared in the contracts; production access is relationship-managed through Citi sales.'
maintainers:
- FN: Kin Lane
  email: kin@apievangelist.com
common:
- type: AgenticAccess
  url: agentic-access/citi-agentic-access.yml
- type: Spectral
  url: rules/citi-rules.yml
- type: JSONLD
  url: json-ld/citi-context.jsonld
- type: Vocabulary
  url: vocabulary/citi-vocabulary.yml
- type: Hosts
  url: hosts/citi-hosts.yml
- type: Vendors
  url: vendors/citi-vendors.yml
- type: CapabilityMap
  url: capabilities/citi-capability-edges.yml
  name: Citi Business Capability Map
- type: Overlay
  url: overlays/citi-authentication-overlay.yaml
- type: Overlay
  url: overlays/citi-account-reporting-overlay.yaml
- type: Overlay
  url: overlays/citi-outgoing-payments-overlay.yaml
- type: Overlay
  url: overlays/citi-accept-payments-overlay.yaml
- type: Overlay
  url: overlays/citi-commercial-cards-overlay.yaml
- type: Overlay
  url: overlays/citi-fx-overlay.yaml
- type: Overlay
  url: overlays/citi-custody-overlay.yaml
- type: Overlay
  url: overlays/citi-transfer-agency-overlay.yaml
- type: Overlay
  url: overlays/citi-open-banking-overlay.yaml
- type: Overlay
  url: overlays/citi-trade-overlay.yaml
- type: Overlay
  url: overlays/citi-gateway-services-overlay.yaml
- type: Overlay
  url: overlays/citi-additional-payment-services-overlay.yaml
- type: Website
  url: https://www.citi.com
- type: DeveloperPortal
  url: https://developer.citi.com/apis/marketplace
- type: Portal
  url: https://partner.citi.com/developers
- type: Documentation
  url: https://developer.citi.com/apidocs/
- type: APIReference
  url: https://developer.citi.com/apidocs/
- type: GettingStarted
  url: https://developer.citi.com/apidocs/authentication/authentication-only-guide
- type: SignUp
  url: https://partner.citi.com/user/register
- type: Login
  url: https://partner.citi.com/user/login
- type: Support
  url: https://partner.citi.com/contact-us
- type: TermsOfService
  url: https://partner.citi.com/legal/terms
- type: PrivacyPolicy
  url: https://partner.citi.com/legal/privacy-policy
- type: Blog
  url: https://www.citigroup.com/global/news
- type: GitHubOrganization
  url: https://github.com/citi
- type: LinkedIn
  url: https://www.linkedin.com/company/citi
- type: Sandbox
  url: sandbox/citi-sandbox.yml
- type: Documentation
  url: https://www.citigroup.com/global/insights/citiconnect-api-portal
- type: Authentication
  url: authentication/citi-authentication.yml
- type: OAuthScopes
  url: scopes/citi-scopes.yml
- type: Conventions
  url: conventions/citi-conventions.yml
- type: Idempotency
  url: conventions/citi-conventions.yml
- type: Conformance
  url: conformance/citi-conformance.yml
- type: Compliance
  url: conformance/citi-conformance.yml
- type: ErrorCatalog
  url: errors/citi-problem-types.yml
- type: DeclineCodes
  url: errors/citi-decline-codes.yml
- type: Lifecycle
  url: lifecycle/citi-lifecycle.yml
- type: Deprecation
  url: lifecycle/citi-lifecycle.yml
- type: DataModel
  url: data-model/citi-data-model.yml
- type: Webhooks
  url: asyncapi/citi-webhooks.yml
- type: AgentSkill
  url: skills/_index.yml
- type: MCPServer
  url: mcp/citi-mcp.yml
- type: DomainSecurity
  url: security/citi-domain-security.yml
- type: VulnerabilityDisclosure
  url: security/citi-vulnerability-disclosure.yml
- type: Security
  url: https://www.citi.com/reporting-vulnerability
apis:
- aid: citi:citi-account-notification-api
  name: Citi Account Notification API
  description: The Account Notification API from Citi — 1 operation(s) for account notification.
  humanURL: https://developer.citi.com/apidocs/authentication/authentication-only-guide
  baseURL: https://tts.apib2b.citi.com/citiconnect/prod
  tags:
  - Account Notification
  properties:
  - type: OpenAPI
    url: openapi/citi-account-notification-api-openapi.yml
  - type: Documentation
    url: https://developer.citi.com/apidocs/authentication/authentication-only-guide
  - type: APIReference
    url: https://developer.citi.com/apidocs/authentication/authentication-api-reference
  - type: Authentication
    url: authentication/citi-authentication.yml
  - type: Conventions
    url: conventions/citi-conventions.yml
  - type: ErrorCatalog
    url: errors/citi-problem-types.yml
  - type: Sandbox
    url: sandbox/citi-sandbox.yml
  - type: Documentation
    url: https://developer.citi.com/apidocs/account-reporting/balances/balances-overview
  - type: APIReference
    url: https://developer.citi.com/apidocs/account-reporting/balances/balances-api-reference
  - type: Documentation
    url: https://developer.citi.com/apidocs/outgoing-payments/payments/payments-overview
  - type: APIReference
    url: https://developer.citi.com/apidocs/outgoing-payments/payments/payments-api-reference
  - type: Webhooks
    url: asyncapi/citi-webhooks.yml
  - type: DeclineCodes
    url: errors/citi-decline-codes.yml
  - type: Documentation
    url: https://developer.citi.com/apidocs/accept-payments/online-payment-acceptance/online-payment-acceptance-overview
  - type: APIReference
    url: https://developer.citi.com/apidocs/accept-payments/online-payment-acceptance/online-payment-acceptance-api-reference
  - type: Documentation
    url: https://developer.citi.com/apidocs/commercial-cards/virtual-cards/commercial-cards-overview
  - type: APIReference
    url: https://developer.citi.com/apidocs/commercial-cards/virtual-cards/virtual-cards-api-reference
  - type: Documentation
    url: https://developer.citi.com/apidocs/fx/gateway/citifx-gateway-overview
  - type: APIReference
    url: https://developer.citi.com/apidocs/fx/instant-fx/instant-fx-overview
  - type: Documentation
    url: https://developer.citi.com/apidocs/custody/accounts/accounts-overview
  - type: APIReference
    url: https://developer.citi.com/apidocs/custody/safekeeping-positions/safekeeping-positions-api-reference
  - type: Documentation
    url: https://developer.citi.com/apidocs/transfer-agency/accounts/accounts-overview
  - type: APIReference
    url: https://developer.citi.com/apidocs/transfer-agency/accounts/accounts-api-reference
  - type: Documentation
    url: https://developer.citi.com/apidocs/open-banking/ukraine-open-banking/ukraine-open-banking-overview
  - type: APIReference
    url: https://developer.citi.com/apidocs/open-banking/ukraine-open-banking/ukraine-bank-data-sharing-api-reference
  - type: Documentation
    url: https://developer.citi.com/apidocs/trade/standby-letters-of-credit/trade-overview
  - type: APIReference
    url: https://developer.citi.com/apidocs/trade/standby-letters-of-credit/trade-api-reference
  - type: Documentation
    url: https://developer.citi.com/apidocs/gateway-services/gateway-services-user-guide
  - type: APIReference
    url: https://developer.citi.com/apidocs/gateway-services/gateway-services-api-reference
  - type: Documentation
    url: https://developer.citi.com/apidocs/additional-payment-services/additional-payment-services/additional-payment-services-overview
  - type: APIReference
    url: https://developer.citi.com/apidocs/additional-payment-services/additional-payment-services/additional-payment-services-api-reference
  - type: JSONSchema
    url: json-schema/citi-subscription-req-type-schema.json
  - type: JSONSchema
    url: json-schema/citi-subscription-response-schema.json
- aid: citi:citi-accounts-api
  name: Citi Accounts API
  description: The Accounts API from Citi — 6 operation(s) for accounts.
  humanURL: https://developer.citi.com/apidocs/authentication/authentication-only-guide
  baseURL: https://tts.apib2b.citi.com/citiconnect/prod
  tags:
  - Account
  tags_raw:
  - Accounts
  properties:
  - type: OpenAPI
    url: openapi/citi-accounts-api-openapi.yml
  - type: Documentation
    url: https://developer.citi.com/apidocs/authentication/authentication-only-guide
  - type: APIReference
    url: https://developer.citi.com/apidocs/authentication/authentication-api-reference
  - type: Authentication
    url: authentication/citi-authentication.yml
  - type: Conventions
    url: conventions/citi-conventions.yml
  - type: ErrorCatalog
    url: errors/citi-problem-types.yml
  - type: Sandbox
    url: sandbox/citi-sandbox.yml
  - type: Documentation
    url: https://developer.citi.com/apidocs/account-reporting/balances/balances-overview
  - type: APIReference
    url: https://developer.citi.com/apidocs/account-reporting/balances/balances-api-reference
  - type: Documentation
    url: https://developer.citi.com/apidocs/outgoing-payments/payments/payments-overview
  - type: APIReference
    url: https://developer.citi.com/apidocs/outgoing-payments/payments/payments-api-reference
  - type: Webhooks
    url: asyncapi/citi-webhooks.yml
  - type: DeclineCodes
    url: errors/citi-decline-codes.yml
  - type: Documentation
    url: https://developer.citi.com/apidocs/accept-payments/online-payment-acceptance/online-payment-acceptance-overview
  - type: APIReference
    url: https://developer.citi.com/apidocs/accept-payments/online-payment-acceptance/online-payment-acceptance-api-reference
  - type: Documentation
    url: https://developer.citi.com/apidocs/commercial-cards/virtual-cards/commercial-cards-overview
  - type: APIReference
    url: https://developer.citi.com/apidocs/commercial-cards/virtual-cards/virtual-cards-api-reference
  - type: Documentation
    url: https://developer.citi.com/apidocs/fx/gateway/citifx-gateway-overview
  - type: APIReference
    url: https://developer.citi.com/apidocs/fx/instant-fx/instant-fx-overview
  - type: Documentation
    url: https://developer.citi.com/apidocs/custody/accounts/accounts-overview
  - type: APIReference
    url: https://developer.citi.com/apidocs/custody/safekeeping-positions/safekeeping-positions-api-reference
  - type: Documentation
    url: https://developer.citi.com/apidocs/transfer-agency/accounts/accounts-overview
  - type: APIReference
    url: https://developer.citi.com/apidocs/transfer-agency/accounts/accounts-api-reference
  - type: Documentation
    url: https://developer.citi.com/apidocs/open-banking/ukraine-open-banking/ukraine-open-banking-overview
  - type: APIReference
    url: https://developer.citi.com/apidocs/open-banking/ukraine-open-banking/ukraine-bank-data-sharing-api-reference
  - type: Documentation
    url: https://developer.citi.com/apidocs/trade/standby-letters-of-credit/trade-overview
  - type: APIReference
    url: https://developer.citi.com/apidocs/trade/standby-letters-of-credit/trade-api-reference
  - type: Documentation
    url: https://developer.citi.com/apidocs/gateway-services/gateway-services-user-guide
  - type: APIReference
    url: https://developer.citi.com/apidocs/gateway-services/gateway-services-api-reference
  - type: Documentation
    url: https://developer.citi.com/apidocs/additional-payment-services/additional-payment-services/additional-payment-services-overview
  - type: APIReference
    url: https://developer.citi.com/apidocs/additional-payment-services/additional-payment-services/additional-payment-services-api-reference
  - type: JSONSchema
    url: json-schema/citi-bal-inquiry-request-schema.json
  - type: JSONSchema
    url: json-schema/citi-bal-inquiry-response-schema.json
  - type: JSONSchema
    url: json-schema/citi-statement-transactions-inbound-request-schema.json
  - type: JSONSchema
    url: json-schema/citi-unbilled-transactions-inbound-request-schema.json
  - type: JSONSchema
    url: json-schema/citi-unbilled-transactions-inbound-response-schema.json
  - type: JSONSchema
    url: json-schema/citi-account-summary-inbound-request-schema.json
- aid: citi:citi-addonservices-api
  name: Citi Addonservices API
  description: The Addonservices API from Citi — 1 operation(s) for addonservices.
  humanURL: https://developer.citi.com/apidocs/authentication/authentication-only-guide
  baseURL: https://tts.apib2b.citi.com/citiconnect/prod
  tags:
  - Addonservices
  properties:
  - type: OpenAPI
    url: openapi/citi-addonservices-api-openapi.yml
  - type: Documentation
    url: https://developer.citi.com/apidocs/authentication/authentication-only-guide
  - type: APIReference
    url: https://developer.citi.com/apidocs/authentication/authentication-api-reference
  - type: Authentication
    url: authentication/citi-authentication.yml
  - type: Conventions
    url: conventions/citi-conventions.yml
  - type: ErrorCatalog
    url: errors/citi-problem-types.yml
  - type: Sandbox
    url: sandbox/citi-sandbox.yml
  - type: Documentation
    url: https://developer.citi.com/apidocs/account-reporting/balances/balances-overview
  - type: APIReference
    url: https://developer.citi.com/apidocs/account-reporting/balances/balances-api-reference
  - type: Documentation
    url: https://developer.citi.com/apidocs/outgoing-payments/payments/payments-overview
  - type: APIReference
    url: https://developer.citi.com/apidocs/outgoing-payments/payments/payments-api-reference
  - type: Webhooks
    url: asyncapi/citi-webhooks.yml
  - type: DeclineCodes
    url: errors/citi-decline-codes.yml
  - type: Documentation
    url: https://developer.citi.com/apidocs/accept-payments/online-payment-acceptance/online-payment-acceptance-overview
  - type: APIReference
    url: https://developer.citi.com/apidocs/accept-payments/online-payment-acceptance/online-payment-acceptance-api-reference
  - type: Documentation
    url: https://developer.citi.com/apidocs/commercial-cards/virtual-cards/commercial-cards-overview
  - type: APIReference
    url: https://developer.citi.com/apidocs/commercial-cards/virtual-cards/virtual-cards-api-reference
  - type: Documentation
    url: https://developer.citi.com/apidocs/fx/gateway/citifx-gateway-overview
  - type: APIReference
    url: https://developer.citi.com/apidocs/fx/instant-fx/instant-fx-overview
  - type: Documentation
    url: https://developer.citi.com/apidocs/custody/accounts/accounts-overview
  - type: APIReference
    url: https://developer.citi.com/apidocs/custody/safekeeping-positions/safekeeping-positions-api-reference
  - type: Documentation
    url: https://developer.citi.com/apidocs/transfer-agency/accounts/accounts-overview
  - type: APIReference
    url: https://developer.citi.com/apidocs/transfer-agency/accounts/accounts-api-reference
  - type: Documentation
    url: https://developer.citi.com/apidocs/open-banking/ukraine-open-banking/ukraine-open-banking-overview
  - type: APIReference
    url: https://developer.citi.com/apidocs/open-banking/ukraine-open-banking/ukraine-bank-data-sharing-api-reference
  - type: Documentation
    url: https://developer.citi.com/apidocs/trade/standby-letters-of-credit/trade-overview
  - type: APIReference
    url: https://developer.citi.com/apidocs/trade/standby-letters-of-credit/trade-api-reference
  - type: Documentation
    url: https://developer.citi.com/apidocs/gateway-services/gateway-services-user-guide
  - type: APIReference
    url: https://developer.citi.com/apidocs/gateway-services/gateway-services-api-reference
  - type: Documentation
    url: https://developer.citi.com/apidocs/additional-payment-services/additional-payment-services/additional-payment-services-overview
  - type: APIReference
    url: https://developer.citi.com/apidocs/additional-payment-services/additional-payment-services/additional-payment-services-api-reference
  - type: JSONSchema
    url: json-schema/citi-entity-id-request-schema.json
- aid: citi:citi-authentication-api
  name: Citi Authentication API
  description: The Authentication API from Citi — 3 operation(s) for authentication.
  humanURL: https://developer.citi.com/apidocs/authentication/authentication-only-guide
  baseURL: https://tts.apib2b.citi.com/citiconnect/prod
  tags:
  - Authentication
  properties:
  - type: OpenAPI
    url: openapi/citi-authentication-api-openapi.yml
  - type: Documentation
    url: https://developer.citi.com/apidocs/authentication/authentication-only-guide
  - type: APIReference
    url: https://developer.citi.com/apidocs/authentication/authentication-api-reference
  - type: Authentication
    url: authentication/citi-authentication.yml
  - type: Conventions
    url: conventions/citi-conventions.yml
  - type: ErrorCatalog
    url: errors/citi-problem-types.yml
  - type: Sandbox
    url: sandbox/citi-sandbox.yml
  - type: Documentation
    url: https://developer.citi.com/apidocs/account-reporting/balances/balances-overview
  - type: APIReference
    url: https://developer.citi.com/apidocs/account-reporting/balances/balances-api-reference
  - type: Documentation
    url: https://developer.citi.com/apidocs/outgoing-payments/payments/payments-overview
  - type: APIReference
    url: https://developer.citi.com/apidocs/outgoing-payments/payments/payments-api-reference
  - type: Webhooks
    url: asyncapi/citi-webhooks.yml
  - type: DeclineCodes
    url: errors/citi-decline-codes.yml
  - type: Documentation
    url: https://developer.citi.com/apidocs/accept-payments/online-payment-acceptance/online-payment-acceptance-overview
  - type: APIReference
    url: https://developer.citi.com/apidocs/accept-payments/online-payment-acceptance/online-payment-acceptance-api-reference
  - type: Documentation
    url: https://developer.citi.com/apidocs/commercial-cards/virtual-cards/commercial-cards-overview
  - type: APIReference
    url: https://developer.citi.com/apidocs/commercial-cards/virtual-cards/virtual-cards-api-reference
  - type: Documentation
    url: https://developer.citi.com/apidocs/fx/gateway/citifx-gateway-overview
  - type: APIReference
    url: https://developer.citi.com/apidocs/fx/instant-fx/instant-fx-overview
  - type: Documentation
    url: https://developer.citi.com/apidocs/custody/accounts/accounts-overview
  - type: APIReference
    url: https://developer.citi.com/apidocs/custody/safekeeping-positions/safekeeping-positions-api-reference
  - type: Documentation
    url: https://developer.citi.com/apidocs/transfer-agency/accounts/accounts-overview
  - type: APIReference
    url: https://developer.citi.com/apidocs/transfer-agency/accounts/accounts-api-reference
  - type: Documentation
    url: https://developer.citi.com/apidocs/open-banking/ukraine-open-banking/ukraine-open-banking-overview
  - type: APIReference
    url: https://developer.citi.com/apidocs/open-banking/ukraine-open-banking/ukraine-bank-data-sharing-api-reference
  - type: Documentation
    url: https://developer.citi.com/apidocs/trade/standby-letters-of-credit/trade-overview
  - type: APIReference
    url: https://developer.citi.com/apidocs/trade/standby-letters-of-credit/trade-api-reference
  - type: Documentation
    url: https://developer.citi.com/apidocs/gateway-services/gateway-services-user-guide
  - type: APIReference
    url: https://developer.citi.com/apidocs/gateway-services/gateway-services-api-reference
  - type: Documentation
    url: https://developer.citi.com/apidocs/additional-payment-services/additional-payment-services/additional-payment-services-overview
  - type: APIReference
    url: https://developer.citi.com/apidocs/additional-payment-services/additional-payment-services/additional-payment-services-api-reference
  - type: JSONSchema
    url: json-schema/citi-authentication-response-schema.json
  - type: JSONSchema
    url: json-schema/citi-response-schema.json
  - type: JSONSchema
    url: json-schema/citi-authentication-payer-response-schema.json
  - type: JSONSchema
    url: json-schema/citi-authentication-payer-request-schema.json
  - type: JSONSchema
    url: json-schema/citi-request-schema.json
  - type: JSONSchema
    url: json-schema/citi-authentication-request-schema.json
- aid: citi:citi-authenticationservices-api
  name: Citi Authenticationservices API
  description: The Authenticationservices API from Citi — 4 operation(s) for authenticationservices.
  humanURL: https://developer.citi.com/apidocs/authentication/authentication-only-guide
  baseURL: https://tts.apib2b.citi.com/citiconnect/prod
  tags:
  - Authenticationservices
  properties:
  - type: OpenAPI
    url: openapi/citi-authenticationservices-api-openapi.yml
  - type: Documentation
    url: https://developer.citi.com/apidocs/authentication/authentication-only-guide
  - type: APIReference
    url: https://developer.citi.com/apidocs/authentication/authentication-api-reference
  - type: Authentication
    url: authentication/citi-authentication.yml
  - type: Conventions
    url: conventions/citi-conventions.yml
  - type: ErrorCatalog
    url: errors/citi-problem-types.yml
  - type: Sandbox
    url: sandbox/citi-sandbox.yml
  - type: Documentation
    url: https://developer.citi.com/apidocs/account-reporting/balances/balances-overview
  - type: APIReference
    url: https://developer.citi.com/apidocs/account-reporting/balances/balances-api-reference
  - type: Documentation
    url: https://developer.citi.com/apidocs/outgoing-payments/payments/payments-overview
  - type: APIReference
    url: https://developer.citi.com/apidocs/outgoing-payments/payments/payments-api-reference
  - type: Webhooks
    url: asyncapi/citi-webhooks.yml
  - type: DeclineCodes
    url: errors/citi-decline-codes.yml
  - type: Documentation
    url: https://developer.citi.com/apidocs/accept-payments/online-payment-acceptance/online-payment-acceptance-overview
  - type: APIReference
    url: https://developer.citi.com/apidocs/accept-payments/online-payment-acceptance/online-payment-acceptance-api-reference
  - type: Documentation
    url: https://developer.citi.com/apidocs/commercial-cards/virtual-cards/commercial-cards-overview
  - type: APIReference
    url: https://developer.citi.com/apidocs/commercial-cards/virtual-cards/virtual-cards-api-reference
  - type: Documentation
    url: https://developer.citi.com/apidocs/fx/gateway/citifx-gateway-overview
  - type: APIReference
    url: https://developer.citi.com/apidocs/fx/instant-fx/instant-fx-overview
  - type: Documentation
    url: https://developer.citi.com/apidocs/custody/accounts/accounts-overview
  - type: APIReference
    url: https://developer.citi.com/apidocs/custody/safekeeping-positions/safekeeping-positions-api-reference
  - type: Documentation
    url: https://developer.citi.com/apidocs/transfer-agency/accounts/accounts-overview
  - type: APIReference
    url: https://developer.citi.com/apidocs/transfer-agency/accounts/accounts-api-reference
  - type: Documentation
    url: https://developer.citi.com/apidocs/open-banking/ukraine-open-banking/ukraine-open-banking-overview
  - type: APIReference
    url: https://developer.citi.com/apidocs/open-banking/ukraine-open-banking/ukraine-bank-data-sharing-api-reference
  - type: Documentation
    url: https://developer.citi.com/apidocs/trade/standby-letters-of-credit/trade-overview
  - type: APIReference
    url: https://developer.citi.com/apidocs/trade/standby-letters-of-credit/trade-api-reference
  - type: Documentation
    url: https://developer.citi.com/apidocs/gateway-services/gateway-services-user-guide
  - type: APIReference
    url: https://developer.citi.com/apidocs/gateway-services/gateway-services-api-reference
  - type: Documentation
    url: https://developer.citi.com/apidocs/additional-payment-services/additional-payment-services/additional-payment-services-overview
  - type: APIReference
    url: https://developer.citi.com/apidocs/additional-payment-services/additional-payment-services/additional-payment-services-api-reference
  - type: JSONSchema
    url: json-schema/citi-response-2-schema.json
  - type: JSONSchema
    url: json-schema/citi-response-schema.json
  - type: JSONSchema
    url: json-schema/citi-o-auth-token-2-schema.json
  - type: JSONSchema
    url: json-schema/citi-o-auth-token-schema.json
  - type: JSONSchema
    url: json-schema/citi-token-schema.json
  - type: JSONSchema
    url: json-schema/citi-token-2-schema.json
- aid: citi:citi-authorization-api
  name: Citi Authorization API
  description: Dual Auth Authorization Request and Response
  humanURL: https://developer.citi.com/apidocs/authentication/authentication-only-guide
  baseURL: https://tts.apib2b.citi.com/citiconnect/prod
  tags:
  - Authorization
  properties:
  - type: OpenAPI
    url: openapi/citi-authorization-api-openapi.yml
  - type: Documentation
    url: https://developer.citi.com/apidocs/authentication/authentication-only-guide
  - type: APIReference
    url: https://developer.citi.com/apidocs/authentication/authentication-api-reference
  - type: Authentication
    url: authentication/citi-authentication.yml
  - type: Conventions
    url: conventions/citi-conventions.yml
  - type: ErrorCatalog
    url: errors/citi-problem-types.yml
  - type: Sandbox
    url: sandbox/citi-sandbox.yml
  - type: Documentation
    url: https://developer.citi.com/apidocs/account-reporting/balances/balances-overview
  - type: APIReference
    url: https://developer.citi.com/apidocs/account-reporting/balances/balances-api-reference
  - type: Documentation
    url: https://developer.citi.com/apidocs/outgoing-payments/payments/payments-overview
  - type: APIReference
    url: https://developer.citi.com/apidocs/outgoing-payments/payments/payments-api-reference
  - type: Webhooks
    url: asyncapi/citi-webhooks.yml
  - type: DeclineCodes
    url: errors/citi-decline-codes.yml
  - type: Documentation
    url: https://developer.citi.com/apidocs/accept-payments/online-payment-acceptance/online-payment-acceptance-overview
  - type: APIReference
    url: https://developer.citi.com/apidocs/accept-payments/online-payment-acceptance/online-payment-acceptance-api-reference
  - type: Documentation
    url: https://developer.citi.com/apidocs/commercial-cards/virtual-cards/commercial-cards-overview
  - type: APIReference
    url: https://developer.citi.com/apidocs/commercial-cards/virtual-cards/virtual-cards-api-reference
  - type: Documentation
    url: https://developer.citi.com/apidocs/fx/gateway/citifx-gateway-overview
  - type: APIReference
    url: https://developer.citi.com/apidocs/fx/instant-fx/instant-fx-overview
  - type: Documentation
    url: https://developer.citi.com/apidocs/custody/accounts/accounts-overview
  - type: APIReference
    url: https://developer.citi.com/apidocs/custody/safekeeping-positions/safekeeping-positions-api-reference
  - type: Documentation
    url: https://developer.citi.com/apidocs/transfer-agency/accounts/accounts-overview
  - type: APIReference
    url: https://developer.citi.com/apidocs/transfer-agency/accounts/accounts-api-reference
  - type: Documentation
    url: https://developer.citi.com/apidocs/open-banking/ukraine-open-banking/ukraine-open-banking-overview
  - type: APIReference
    url: https://developer.citi.com/apidocs/open-banking/ukraine-open-banking/ukraine-bank-data-sharing-api-reference
  - type: Documentation
    url: https://developer.citi.com/apidocs/trade/standby-letters-of-credit/trade-overview
  - type: APIReference
    url: https://developer.citi.com/apidocs/trade/standby-letters-of-credit/trade-api-reference
  - type: Documentation
    url: https://developer.citi.com/apidocs/gateway-services/gateway-services-user-guide
  - type: APIReference
    url: https://developer.citi.com/apidocs/gateway-services/gateway-services-api-reference
  - type: Documentation
    url: https://developer.citi.com/apidocs/additional-payment-services/additional-payment-services/additional-payment-services-overview
  - type: APIReference
    url: https://developer.citi.com/apidocs/additional-payment-services/additional-payment-services/additional-payment-services-api-reference
  - type: JSONSchema
    url: json-schema/citi-authorization-request-schema.json
  - type: JSONSchema
    url: json-schema/citi-authorization-response-schema.json
- aid: citi:citi-balance-api
  name: Citi Balance API
  description: The Balance API from Citi — 1 operation(s) for balance.
  humanURL: https://developer.citi.com/apidocs/authentication/authentication-only-guide
  baseURL: https://tts.apib2b.citi.com/citiconnect/prod
  tags:
  - Balances
  tags_raw:
  - Balance
  properties:
  - type: OpenAPI
    url: openapi/citi-balance-api-openapi.yml
  - type: Documentation
    url: https://developer.citi.com/apidocs/authentication/authentication-only-guide
  - type: APIReference
    url: https://developer.citi.com/apidocs/authentication/authentication-api-reference
  - type: Authentication
    url: authentication/citi-authentication.yml
  - type: Conventions
    url: conventions/citi-conventions.yml
  - type: ErrorCatalog
    url: errors/citi-problem-types.yml
  - type: Sandbox
    url: sandbox/citi-sandbox.yml
  - type: Documentation
    url: https://developer.citi.com/apidocs/account-reporting/balances/balances-overview
  - type: APIReference
    url: https://developer.citi.com/apidocs/account-reporting/balances/balances-api-reference
  - type: Documentation
    url: https://developer.citi.com/apidocs/outgoing-payments/payments/payments-overview
  - type: APIReference
    url: https://developer.citi.com/apidocs/outgoing-payments/payments/payments-api-reference
  - type: Webhooks
    url: asyncapi/citi-webhooks.yml
  - type: DeclineCodes
    url: errors/citi-decline-codes.yml
  - type: Documentation
    url: https://developer.citi.com/apidocs/accept-payments/online-payment-acceptance/online-payment-acceptance-overview
  - type: APIReference
    url: https://developer.citi.com/apidocs/accept-payments/online-payment-acceptance/online-payment-acceptance-api-reference
  - type: Documentation
    url: https://developer.citi.com/apidocs/commercial-cards/virtual-cards/commercial-cards-overview
  - type: APIReference
    url: https://developer.citi.com/apidocs/commercial-cards/virtual-cards/virtual-cards-api-reference
  - type: Documentation
    url: https://developer.citi.com/apidocs/fx/gateway/citifx-gateway-overview
  - type: APIReference
    url: https://developer.citi.com/apidocs/fx/instant-fx/instant-fx-overview
  - type: Documentation
    url: https://developer.citi.com/apidocs/custody/accounts/accounts-overview
  - type: APIReference
    url: https://developer.citi.com/apidocs/custody/safekeeping-positions/safekeeping-positions-api-reference
  - type: Documentation
    url: https://developer.citi.com/apidocs/transfer-agency/accounts/accounts-overview
  - type: APIReference
    url: https://developer.citi.com/apidocs/transfer-agency/accounts/accounts-api-reference
  - type: Documentation
    url: https://developer.citi.com/apidocs/open-banking/ukraine-open-banking/ukraine-open-banking-overview


# --- truncated at 32 KB (395 KB total) ---
# Full source: https://raw.githubusercontent.com/api-evangelist/citi/refs/heads/main/apis.yml

Work with this as data

Every provider here is available over the APIs.io API and to AI agents over MCP.

MCP server

One button, every client — Claude, Cursor, VS Code and the rest.

https://apis.io/mcp

Tools for providers

9 MCP tools reach this
  • find_providersBrowse and filter every provider in the catalog.
  • get_provider_artifactsEvery artifact this provider publishes, grouped by type.
  • get_provider_operationsEvery operation across all of their OpenAPIs — one call instead of parsing every spec.
  • get_provider_toolsEvery MCP tool they ship, with the operation each wraps.
  • get_provider_evidenceHow each part of their score was established. Free — the basis for a claim should not sit behind it.
  • get_provider_ratingPRO — composite, band, trend and facet scores.
  • apis_io_searchSTART HERE — APIs, providers and tags for one query, each with its total.
  • resolveTurn a domain, URL or GitHub org into the provider it belongs to.
  • find_cohortsEvery scored population of providers in the catalog.
All 92 tools →

Call it yourself

curl for this page
This provider 
curl "https://apis.io/api/v1/providers/citi"
All providers 
curl "https://apis.io/api/v1/providers?limit=25"
Every operation they expose 
curl "https://apis.io/api/v1/providers/citi/operations?limit=25"
How their score was established 
curl "https://apis.io/api/v1/providers/citi/evidence"

Discovery needs no key. Ratings and market analysis are Pro.

Get an API key

Free tier, no form to fill in. Signing in shares your email address with us — we store it to create your key and to recognise you if you sign in with another provider. See our Privacy Policy and Terms.

GitHub Google LinkedIn

A second provider on the same verified email joins the account you already have.