Citi · Schema
GetLinkAccountResponse
Response body containing linked account details.
BankingFinancial ServicesOpen BankingPaymentsTreasuryISO 20022Commercial CardsForeign ExchangeCustodyTrade FinanceCorporate BankingAPI Gateway
JSON Schema
{
"$schema": "https://json-schema.org/draft/2020-12/schema",
"$id": "https://raw.githubusercontent.com/api-evangelist/citi/main/json-schema/citi-get-link-account-response-schema.json",
"title": "GetLinkAccountResponse",
"description": "Response body containing linked account details.",
"x-generated": "2026-10-12",
"x-method": "derived",
"x-generator": "derive-json-schema.py",
"x-source": "openapi/citi-linkaccount-api-openapi.yml#/components/schemas/Get-Link-Account-Response",
"type": "array",
"items": {
"$ref": "#/$defs/Creditor-Detail"
},
"$defs": {
"Address-Details": {
"title": "AddressDetails",
"type": "object",
"description": "Address information for the bank.",
"properties": {
"city": {
"type": "string",
"title": "city",
"description": "City.",
"minLength": 1,
"maxLength": 128
},
"state": {
"type": "string",
"title": "state",
"description": "State.",
"minLength": 1,
"maxLength": 128
},
"country_code": {
"allOf": [
{
"$ref": "#/$defs/Country-Code"
}
],
"title": "country_code",
"description": "Country code."
},
"address_line": {
"type": "string",
"title": "address_line",
"description": "Detailed address of the bank.",
"minLength": 1,
"maxLength": 256
}
}
},
"Common-Creditor": {
"title": "CommonCreditor",
"type": "object",
"description": "This section contains the details information of creditor.",
"properties": {
"type": {
"type": "string",
"title": "type",
"description": "Type of creditor.",
"enum": [
"00"
]
},
"name": {
"allOf": [
{
"$ref": "#/$defs/Name"
},
{
"description": "Name of the account."
}
]
},
"contact_number": {
"type": "string",
"title": "contact_number",
"description": "Full contact number.",
"minLength": 1,
"maxLength": 32
},
"contact_prefix": {
"type": "string",
"title": "contact_prefix",
"description": "International telephone area code.",
"minLength": 1,
"maxLength": 32
},
"email": {
"type": "string",
"title": "email",
"description": "Email address of the merchant.",
"minLength": 1,
"maxLength": 32
}
}
},
"Country-Code": {
"type": "string",
"title": "country_code",
"pattern": "^[A-Z]{2,2}$",
"description": "Country code."
},
"Created-Time": {
"type": "string",
"format": "date-time",
"description": "Date and time of the file created. Pattern YYYY-MM-DDTHH:mm:ssZ",
"title": "created_time"
},
"Creditor-Account-Details": {
"title": "CreditorAccountDetails",
"type": "object",
"description": "This section contains the details information of account.",
"properties": {
"holder_type": {
"type": "string",
"title": "holder_type",
"description": "The type of account holder.",
"enum": [
"PERSONAL",
"COMPANY"
]
},
"holder_contact_number": {
"type": "string",
"title": "holder_contact_number",
"description": "The full contact number, including the country code if mobile.",
"minLength": 1,
"maxLength": 32
},
"number": {
"type": "string",
"title": "number",
"description": "Unique account number.",
"minLength": 1,
"maxLength": 64
},
"name": {
"allOf": [
{
"$ref": "#/$defs/Name"
},
{
"description": "Name of the account."
}
]
},
"currency_code": {
"allOf": [
{
"$ref": "#/$defs/Currency-Code"
}
],
"title": "currency_code",
"description": "Currency of the account (3-character ISO code)."
},
"iban": {
"type": "string",
"title": "iban",
"description": "International Bank Account Number (IBAN). IBAN is not applicable for CN and HK.",
"minLength": 1,
"maxLength": 32
},
"document_type": {
"type": "string",
"title": "document_type",
"description": "Type of identity document (ID). One of the following 00 Chinese national ID card 01 Chinese residence permit 02 Passport 03 ID card of Hong Kong, Macao or Taiwan 04 Residence permit of Hong Kong, Macao and Taiwan 05 Hong Kong and Macao travel permit 06 Other national ID card 07 Other residence permit",
"enum": [
"CHINESE_NATIONAL_ID_CARD",
"CHINESE_RESIDENCE_PERMIT",
"PASSPORT",
"ID_CARD_OF_HONGKONG_MACAO_OR_TAIWAN",
"RESIDENCE_PERMIT_OF_HONGKONG_MACAO_AND_TAIWAN",
"HONGKONG_AND_MACAO_TRAVEL_PERMIT",
"OTHER_NATIONAL_ID_CARD",
"OTHER_RESIDENCE_PERMIT"
]
},
"document_number": {
"type": "string",
"title": "document_number",
"description": "Account holder's ID number.",
"minLength": 1,
"maxLength": 64
}
}
},
"Creditor-Address-Details": {
"title": "CreditorAddressDetails",
"description": "Address information for the creditor.",
"allOf": [
{
"$ref": "#/$defs/Address-Details"
},
{
"$ref": "#/$defs/Partial-Address"
},
{
"type": "object",
"title": "Creditor-Address-Details"
}
]
},
"Creditor-Bank-Details": {
"title": "CreditorBankDetails",
"type": "object",
"description": "This section contains the details information of bank.",
"properties": {
"name": {
"allOf": [
{
"$ref": "#/$defs/Name"
},
{
"description": "Name of the bank.",
"minLength": 1,
"maxLength": 256
}
]
},
"code": {
"type": "string",
"title": "code",
"description": "Bank code.",
"minLength": 1,
"maxLength": 32
},
"branch_name": {
"type": "string",
"title": "branch_name",
"description": "Branch name where the account is held.",
"minLength": 1,
"maxLength": 128
},
"branch_number": {
"type": "string",
"title": "branch_number",
"description": "Branch code where the account is held.",
"minLength": 1,
"maxLength": 32
},
"swift_code": {
"type": "string",
"title": "swift_code",
"description": "SWIFT BIC (Bank Identifier Code).",
"minLength": 1,
"maxLength": 64
},
"routing_number": {
"type": "string",
"title": "routing_number",
"description": "Routing code.",
"minLength": 1,
"maxLength": 64
},
"ifsc_code": {
"type": "string",
"title": "ifsc_code",
"description": "Indian Financial System Code (IFSC).",
"minLength": 1,
"maxLength": 64
},
"sort_code": {
"type": "string",
"title": "sort_code",
"description": "Sort code.",
"minLength": 1,
"maxLength": 32
}
}
},
"Creditor-Detail": {
"title": "CreditorDetail",
"type": "object",
"description": "Response body containing creditor's details.",
"properties": {
"creditor_id": {
"$ref": "#/$defs/Creditor-Id"
},
"status": {
"allOf": [
{
"$ref": "#/$defs/Status"
}
],
"title": "status",
"description": "The status of creditor validation. PENDING; AVAILABLE; DECLINED"
},
"message": {
"$ref": "#/$defs/Message"
},
"created_time": {
"$ref": "#/$defs/Created-Time"
},
"creditor_account": {
"$ref": "#/$defs/Get-Creditor-Account"
},
"creditor_bank": {
"$ref": "#/$defs/Get-Creditor-Bank"
},
"creditor": {
"$ref": "#/$defs/Get-Creditor"
},
"file_id": {
"$ref": "#/$defs/File-Id"
}
}
},
"Creditor-Id": {
"type": "string",
"title": "creditor_id",
"description": "The unique creditor identifier assigned by payment service provider.",
"minLength": 1,
"maxLength": 36
},
"Currency-Code": {
"type": "string",
"title": "currency_code",
"description": "The currency code in the transaction.",
"pattern": "^[A-Z]{3}$"
},
"File-Id": {
"type": "string",
"description": "Unique identifier for the document uploaded.",
"title": "file_id",
"minLength": 1,
"maxLength": 128
},
"Get-Creditor": {
"title": "GetCreditor",
"description": "This section contains the details information of creditor.",
"allOf": [
{
"$ref": "#/$defs/Common-Creditor"
},
{
"type": "object",
"title": "Get-Creditor",
"properties": {
"address": {
"$ref": "#/$defs/Creditor-Address-Details"
}
}
}
]
},
"Get-Creditor-Account": {
"title": "GetCreditorAccount",
"description": "This section contains the details information of bank.",
"allOf": [
{
"$ref": "#/$defs/Creditor-Account-Details"
},
{
"type": "object",
"title": "Get-Creditor-Account",
"properties": {
"type": {
"type": "string",
"title": "type",
"description": "Type of the bank.",
"minLength": 1,
"maxLength": 64
}
}
}
]
},
"Get-Creditor-Bank": {
"title": "GetCreditorBank",
"description": "This section contains the details information of bank.",
"allOf": [
{
"$ref": "#/$defs/Creditor-Bank-Details"
},
{
"type": "object",
"title": "Get-Creditor-Bank",
"properties": {
"type": {
"type": "string",
"title": "type",
"description": "Type of the bank.",
"minLength": 1,
"maxLength": 64
},
"address": {
"$ref": "#/$defs/Address-Details"
}
}
}
]
},
"Message": {
"type": "string",
"description": "Description of the status.",
"title": "message",
"minLength": 1,
"maxLength": 500
},
"Name": {
"type": "string",
"title": "name",
"minLength": 1,
"maxLength": 128
},
"Partial-Address": {
"title": "PartialAddress",
"description": "Address information for the creditor.",
"type": "object",
"properties": {
"street_name": {
"type": "string",
"title": "street_name",
"description": "Street name.",
"minLength": 1,
"maxLength": 128
},
"postal_code": {
"type": "string",
"title": "postal_code",
"description": "Postal code.",
"minLength": 1,
"maxLength": 16
}
}
},
"Status": {
"type": "string",
"description": "Status of the request.",
"title": "status",
"minLength": 1,
"maxLength": 64
}
}
}Work with this as data
Every JSON Schema 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 schemas
4 MCP tools reach this
find_json_schemasBrowse and filter every JSON Schema in the catalog.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.
Call it yourself
curl for this page
This JSON Schema
curl "https://apis.io/api/v1/json-schemas/citi-get-link-account-response"
All schemas
curl "https://apis.io/api/v1/json-schemas?limit=25"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.
A second provider on the same verified email joins the account you already have.