Citi · Schema

MandateInitiationRequest

BankingFinancial ServicesOpen BankingPaymentsTreasuryISO 20022Commercial CardsForeign ExchangeCustodyTrade FinanceCorporate BankingAPI Gateway

Properties

Name Type Description
mandate_initiation_request object The MandateInitiationRequest message is sent by the initiator of the request to his agent. The initiator can either be the debtor or the creditor. The MandateInitiationRequest message is forwarded by
View JSON Schema on GitHub

JSON Schema

citi-mandate-initiation-request-schema.json Raw ↑
{
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "$id": "https://raw.githubusercontent.com/api-evangelist/citi/main/json-schema/citi-mandate-initiation-request-schema.json",
  "title": "MandateInitiationRequest",
  "x-generated": "2026-10-12",
  "x-method": "derived",
  "x-generator": "derive-json-schema.py",
  "x-source": "openapi/citi-emandateservices-api-openapi.yml#/components/schemas/MandateInitiationRequest",
  "type": "object",
  "required": [
    "mandate_initiation_request"
  ],
  "properties": {
    "mandate_initiation_request": {
      "type": "object",
      "description": "The MandateInitiationRequest message is sent by the initiator of the request to his agent. The initiator can either be the debtor or the creditor. The MandateInitiationRequest message is forwarded by the agent of the initiator to the agent of the counterparty. The MandateInitiationRequest message is used to setup the instruction that allows the debtor agent to accept instructions from the creditor, through the creditor agent, to debit the account of the debtor.",
      "allOf": [
        {
          "$ref": "#/$defs/MandateInitiationRequestV06"
        }
      ]
    }
  },
  "$defs": {
    "AccountIdentification4Choice": {
      "type": "object",
      "required": [
        "Othr",
        "iban"
      ],
      "properties": {
        "iban": {
          "type": "object",
          "allOf": [
            {
              "$ref": "#/$defs/IBAN2007Identifier"
            }
          ]
        },
        "Othr": {
          "type": "object",
          "allOf": [
            {
              "$ref": "#/$defs/GenericAccountIdentification1"
            }
          ]
        }
      },
      "description": "Unique and unambiguous identification for the account between the account owner and the account servicer. Either iban or Othr field value should be passed on request."
    },
    "AccountSchemeName1Choice": {
      "type": "object",
      "properties": {
        "code": {
          "type": "string",
          "description": "Specifies the external account identification scheme name code in the format of character string with a maximum length of 4 characters.",
          "minLength": 1,
          "maxLength": 4
        },
        "proprietary": {
          "type": "string",
          "description": "Proprietary Details",
          "minLength": 1,
          "maxLength": 35
        }
      },
      "description": "Name of the identification scheme. Either from Code or Proprietary is Required"
    },
    "ActiveCurrencyAndAmount": {
      "type": "object",
      "properties": {
        "amount": {
          "type": "string",
          "description": "The number of fractional digits (or minor unit of currency) must comply with ISO 4217. Note: The decimal separator is a dot. Total18 digits allowed with up to 5 decimal places."
        },
        "currency": {
          "type": "string",
          "description": "Currency for the amount. Passed as Tag Attribute.",
          "pattern": "[A-Z]{3,3}"
        }
      }
    },
    "ActiveOrHistoricCurrencyCode": {
      "type": "object",
      "properties": {
        "currency": {
          "type": "string",
          "description": "Currency should only be used in case one and the same account number covers several currencies and the initiating party needs to identify which currency needs to be used for settlement on the account.",
          "pattern": "[A-Z]{3,3}"
        }
      },
      "description": "Identification of the currency in which the account is held."
    },
    "AddressType2Code": {
      "type": "string",
      "description": "<br><br><b>ADDR</b>: Address is the complete postal address. <br><br><b>PBOX</b>: Address is a postal office (PO) box. <br><br><b>HOME</b>: Address is the home address. <br><br><b>BIZZ</b>: Address is the business address.<br><br><b>MLTO</b>: Address is the address to which mail is sent.<br><br><b>DLVY</b>: Address is the address to which delivery is to take place.",
      "enum": [
        "ADDR",
        "PBOX",
        "HOME",
        "BIZZ",
        "MLTO",
        "DLVY"
      ]
    },
    "AddressType3Choice": {
      "type": "object",
      "properties": {
        "code": {
          "type": "object",
          "description": "Specifies the type of address.<br><br><b>ADDR</b>: Address is the complete postal address. <br><br><b>PBOX</b>: Address is a postal office (PO) box. <br><br><b>HOME</b>: Address is the home address. <br><br><b>BIZZ</b>: Address is the business address.<br><br><b>MLTO</b>: Address is the address to which mail is sent.<br><br><b>DLVY</b>: Address is the address to which delivery is to take place.",
          "allOf": [
            {
              "$ref": "#/$defs/AddressType2Code"
            }
          ]
        },
        "proprietary": {
          "type": "object",
          "description": "Information related to an identification, for example, party identification or account identification.",
          "allOf": [
            {
              "$ref": "#/$defs/GenericIdentification30"
            }
          ]
        }
      },
      "description": "Either from Code or Proprietary is required."
    },
    "AnyBICDec2014Identifier": {
      "type": "string",
      "pattern": "[A-Z0-9]{4,4}[A-Z]{2,2}[A-Z0-9]{2,2}([A-Z0-9]{3,3}){0,1}"
    },
    "AuthenticationChannel1Choice": {
      "properties": {
        "code": {
          "type": "string",
          "description": "Specifies the transaction authentication channel, as published in an external authentication channel code set.",
          "minLength": 1,
          "maxLength": 4
        },
        "proprietary": {
          "type": "string",
          "description": "Proprietary Details",
          "minLength": 1,
          "maxLength": 35
        }
      },
      "description": "Channel used to transmit the authentication information. Either of Code or Proprietary is Required."
    },
    "Authorisation1Choice": {
      "type": "object",
      "properties": {
        "code": {
          "type": "object",
          "description": "Specifies the level of approval depending on a number of factors, including payment type, threshold amount or local country or operations practice.<br><br><b>AUTH</b>: Indicates a file has been pre-authorized or approved within the originating customer environment and no further approval is required. <br><br><b>FDET</b>: Indicates that a file requires additional file level approval, with the ability to view both the payment information block and supporting customer credit transaction detail. <br><br><b>FSUM</b>: Indicates that a file requires additional file level approval, with the ability to view only the payment information block level information.<br><br><b>ILEV</b>: Indicates that a file requires all customer transactions to be authorized or approved.",
          "allOf": [
            {
              "$ref": "#/$defs/Authorisation1Code"
            }
          ]
        },
        "proprietary": {
          "type": "string",
          "description": "Specifies the proprietary description",
          "minLength": 1,
          "maxLength": 128
        }
      },
      "description": "Either of Code or Proprietary is required."
    },
    "Authorisation1Code": {
      "type": "string",
      "description": "<br><br><b>AUTH</b>: Indicates a file has been pre authorized or approved within the originating customer environment and no further approval is required. <br><br><b>FDET</b>: Indicates that a file requires additional file-level approval, with the ability to view both the payment information block and supporting customer credit transaction detail. <br><br><b>FSUM</b>: Indicates that a file requires additional file level approval, with the ability to view only the payment information block level information. <br><br><b>ILEV</b>: Indicates that a file requires all customer transactions to be authorized or approved.",
      "enum": [
        "AUTH",
        "FDET",
        "FSUM",
        "ILEV"
      ]
    },
    "BICFIDec2014Identifier": {
      "type": "string",
      "pattern": "[A-Z0-9]{4,4}[A-Z]{2,2}[A-Z0-9]{2,2}([A-Z0-9]{3,3}){0,1}"
    },
    "BranchAndFinancialInstitutionIdentification6": {
      "type": "object",
      "required": [
        "FinInstnId"
      ],
      "properties": {
        "branch_identification": {
          "type": "object",
          "allOf": [
            {
              "$ref": "#/$defs/BranchData3"
            }
          ]
        },
        "FinInstnId": {
          "type": "object",
          "allOf": [
            {
              "$ref": "#/$defs/FinancialInstitutionIdentification18"
            }
          ]
        }
      }
    },
    "BranchData3": {
      "type": "object",
      "properties": {
        "identification": {
          "type": "object",
          "description": "Unique and unambiguous identification of a branch of a financial institution.",
          "allOf": [
            {
              "$ref": "#/$defs/Max35Text"
            }
          ]
        },
        "legal_entity": {
          "type": "object",
          "description": "Legal entity identification for the branch of the financial institution.",
          "allOf": [
            {
              "$ref": "#/$defs/LEIIdentifier"
            }
          ]
        },
        "name": {
          "type": "object",
          "description": "Name by which an agent is known and which is usually used to identify that agent.",
          "allOf": [
            {
              "$ref": "#/$defs/Max140Text"
            }
          ]
        },
        "postal_address": {
          "type": "object",
          "description": "Information that locates and identifies a specific address, as defined by postal services.",
          "allOf": [
            {
              "$ref": "#/$defs/PostalAddress24"
            }
          ]
        }
      },
      "description": "Identifies a specific branch of a financial institution."
    },
    "CashAccount38": {
      "type": "object",
      "properties": {
        "currency": {
          "type": "object",
          "description": "Identification of the currency in which the account is held.",
          "allOf": [
            {
              "$ref": "#/$defs/ActiveOrHistoricCurrencyCode"
            }
          ]
        },
        "Id": {
          "type": "object",
          "allOf": [
            {
              "$ref": "#/$defs/AccountIdentification4Choice"
            }
          ]
        },
        "name": {
          "type": "object",
          "description": "Name of the account, as assigned by the account servicing institution, in agreement with the account owner in order to provide an additional means of identification of the account.",
          "allOf": [
            {
              "$ref": "#/$defs/Max70Text"
            }
          ]
        },
        "type": {
          "type": "object",
          "allOf": [
            {
              "$ref": "#/$defs/CashAccountType2Choice"
            }
          ]
        },
        "proxy": {
          "type": "object",
          "description": "Specifies an alternate assumed name for the identification of the account.",
          "properties": {
            "type": {
              "type": "object",
              "description": "Type of the proxy identification. Either of Code or Proprietary is required.",
              "properties": {
                "code": {
                  "type": "string",
                  "description": "Specifies the external proxy account type code, as published in the proxy account type external code set.",
                  "minLength": 1,
                  "maxLength": 4
                },
                "proprietary": {
                  "type": "string",
                  "description": "Proprietary details",
                  "minLength": 1,
                  "maxLength": 35
                }
              }
            },
            "identification": {
              "type": "string",
              "description": "Identification used to indicate the account identification under another specified name.",
              "minLength": 1,
              "maxLength": 2048
            }
          },
          "required": [
            "identification"
          ]
        }
      }
    },
    "CashAccountType2Choice": {
      "type": "object",
      "properties": {
        "code": {
          "type": "string",
          "description": "Specifies the nature, or use, of the cash account in the format of character string with a maximum length of 4 characters. The list of valid codes is an external code list published separately.",
          "minLength": 1,
          "maxLength": 4
        },
        "proprietary": {
          "type": "string",
          "description": "proprietary details",
          "minLength": 1,
          "maxLength": 35
        }
      },
      "description": "Specifies the nature, or use of the account. Either from Code Or Proprietary is required."
    },
    "CategoryPurpose1Choice": {
      "type": "object",
      "properties": {
        "code": {
          "type": "string",
          "description": "Specifies the category purpose, as published in an external category purpose code list.",
          "minLength": 1,
          "maxLength": 4
        },
        "proprietary": {
          "type": "object",
          "description": "Category purpose, in a proprietary form.",
          "allOf": [
            {
              "$ref": "#/$defs/Max35Text"
            }
          ]
        }
      },
      "description": "Specifies the high level purpose of the mandate based on a set of pre-defined categories. Either Code or Proprietary field value should be passed in request."
    },
    "ClearingSystemMemberIdentification2": {
      "type": "object",
      "required": [
        "MmbId"
      ],
      "properties": {
        "clearing_system_identification": {
          "type": "object",
          "description": "Specification of a pre-agreed offering between clearing agents or the channel through which the payment instruction is processed.",
          "properties": {
            "code": {
              "type": "string",
              "description": "Identification of a clearing system, in a coded form as published in an external list.",
              "minLength": 1,
              "maxLength": 5
            },
            "proprietary": {
              "type": "object",
              "description": "Identification code for a clearing system, that has not yet been identified in the list of clearing systems.",
              "allOf": [
                {
                  "$ref": "#/$defs/Max35Text"
                }
              ]
            }
          }
        },
        "MmbId": {
          "type": "object",
          "description": "Identification of a member of a clearing system.",
          "allOf": [
            {
              "$ref": "#/$defs/Max35Text"
            }
          ]
        }
      },
      "description": "Information used to identify a member within a clearing system."
    },
    "Contact4": {
      "type": "object",
      "properties": {
        "name_prefix": {
          "type": "object",
          "description": "Specifies the terms used to formally address a person.<br><br><b>DOCT</b>: Title of the person is Doctor or Dr. <br><br><b>MIST</b>: Title of the person is Mister or Mr. <br><br><b>MISS</b>: Title of the person is Miss. <br><br><b>MADM</b>: Title of the person is Madam.<br><br><b>MIKS</b>: Title of the person is Gender Neutral.",
          "allOf": [
            {
              "$ref": "#/$defs/NamePrefix2Code"
            }
          ]
        },
        "name": {
          "type": "object",
          "description": "Name by which a party is known and which is usually used to identify that party.",
          "allOf": [
            {
              "$ref": "#/$defs/Max140Text"
            }
          ]
        },
        "phone_number": {
          "type": "object",
          "description": "Collection of information that identifies a phone number, as defined by telecom services.",
          "allOf": [
            {
              "$ref": "#/$defs/PhoneNumber"
            }
          ]
        },
        "mobile_number": {
          "type": "object",
          "description": "Collection of information that identifies a mobile phone number, as defined by telecom services.",
          "allOf": [
            {
              "$ref": "#/$defs/PhoneNumber"
            }
          ]
        },
        "fax_number": {
          "type": "object",
          "description": "Collection of information that identifies a FAX number, as defined by telecom services.",
          "allOf": [
            {
              "$ref": "#/$defs/PhoneNumber"
            }
          ]
        },
        "email_address": {
          "type": "object",
          "description": "Address for electronic mail (e-mail).",
          "allOf": [
            {
              "$ref": "#/$defs/Max2048Text"
            }
          ]
        },
        "email_purpose": {
          "type": "object",
          "description": "Purpose for which an email address may be used.",
          "allOf": [
            {
              "$ref": "#/$defs/Max35Text"
            }
          ]
        },
        "job_title": {
          "type": "object",
          "description": "Title of the function.",
          "allOf": [
            {
              "$ref": "#/$defs/Max35Text"
            }
          ]
        },
        "responsibility": {
          "type": "object",
          "description": "Role of a person in an organisation.",
          "allOf": [
            {
              "$ref": "#/$defs/Max35Text"
            }
          ]
        },
        "department": {
          "type": "object",
          "description": "Identification of a division of a large organization or building.",
          "allOf": [
            {
              "$ref": "#/$defs/Max70Text"
            }
          ]
        },
        "other": {
          "type": "array",
          "description": "Contact details in another form.",
          "items": {
            "$ref": "#/$defs/OtherContact1"
          }
        },
        "contact_preferred_method": {
          "type": "object",
          "description": "Preferred method used to reach the contact.<br><br><b>LETT</b>: Preferred method used to reach the contact is per letter. <br><br><b>FAXX</b>: Preferred method used to reach the contact is per fax.<br><br><b>PHON</b>: Preferred method used to reach the contact is per phone. <br><br><b>MAIL</b>: Preferred method used to reach the contact is per Email .<br><br><b>CELL</b>: Preferred method used to reach the contact is per mobile or cell phone.",
          "allOf": [
            {
              "$ref": "#/$defs/PreferredContactMethod1Code"
            }
          ]
        }
      },
      "description": "Set of elements used to indicate how to contact the party."
    },
    "CountryCode": {
      "type": "string",
      "pattern": "[A-Z]{2,2}",
      "description": "Nation with its own government. The code is checked against thelist of country names obtained from the United Nations (ISO 3166, Alpha-2code)."
    },
    "DateAndPlaceOfBirth1": {
      "type": "object",
      "required": [
        "birth_date",
        "city_of_birth",
        "country_of_birth"
      ],
      "properties": {
        "birth_date": {
          "type": "object",
          "description": "Date on which a person is born allOf: - $ref: "
        },
        "province_of_birth": {
          "type": "object",
          "description": "Province where a person was born.",
          "allOf": [
            {
              "$ref": "#/$defs/Max35Text"
            }
          ]
        },
        "city_of_birth": {
          "type": "object",
          "description": "City where a person was born.",
          "allOf": [
            {
              "$ref": "#/$defs/Max35Text"
            }
          ]
        },
        "country_of_birth": {
          "type": "object",
          "description": "Country where a person was born.",
          "allOf": [
            {
              "$ref": "#/$defs/CountryCode"
            }
          ]
        }
      },
      "description": "Date and place of birth of a person."
    },
    "DatePeriodDetails1": {
      "type": "object",
      "required": [
        "from_date"
      ],
      "properties": {
        "from_date": {
          "type": "object",
          "description": "Start date of the range.",
          "allOf": [
            {
              "$ref": "#/$defs/ISODate"
            }
          ]
        },
        "to_date": {
          "type": "object",
          "description": "End date of the range.",
          "allOf": [
            {
              "$ref": "#/$defs/ISODate"
            }
          ]
        }
      },
      "description": "Length of time for which the mandate remains valid."
    },
    "DocumentType6Code": {
      "type": "string",
      "description": "Document type in a coded form.<br><br><b>MSIN</b>: Document is an invoice claiming payment for the supply of metered services, for example gas or electricity supplied to a fixed meter. <br><br><b>CNFA</b>: Document is a credit note for the final amount settled for a commercial transaction.<br><br><b>DNFA</b>: Document is a debit note for the final amount settled for a commercial transaction. <br><br><b>CINV</b>:   Document is an invoice.<br><br><b>CREN</b>: Document is a credit note. <br><br><b>DEBN</b>: Document is a debit note. <br><br><b>HIRI</b>: Document is an invoice for the hiring of human resources or renting goods or equipment. <br><br><b>SBIN</b>: Document is an invoice issued by the debtor. <br><br><b>SVGS</b>: Account used for savings. <br><br><b>CMCN</b>: Document is an agreement between the parties, stipulating the terms and conditions of the delivery of goods or services.<br><br><b>SOAC</b>: Document is a statement of the transactions posted to the debtor's account at the supplier. <br><br><b>DISP</b>: Document is a dispatch advice. <br><br><b>BOLD</b>: Document is a shipping notice. <br><br><b>VCHR</b>: Document is an electronic payment document. <br><br><b>AROI</b>: Document is a payment that applies to a specific source document. <br><br><b>TSUT</b>: Document is a transaction identifier as assigned by the Trade Services Utility.<br><br><b>PUOR</b>: Document is a purchase order.",
      "enum": [
        "MSIN",
        "CNFA",
        "DNFA",
        "CINV",
        "CREN",
        "DEBN",
        "HIRI",
        "SBIN",
        "CMCN",
        "SOAC",
        "DISP",
        "BOLD",
        "VCHR",
        "AROI",
        "TSUT",
        "PUOR"
      ]
    },
    "FinancialIdentificationSchemeName1Choice": {
      "type": "object",
      "properties": {
        "code": {
          "type": "string",
          "description": "Name of the identification scheme, in a coded form as published in an external list.",
          "minLength": 1,
          "maxLength": 4
        },
        "proprietary": {
          "type": "object",
          "description": "Name of the identification scheme, in a free text form.",
          "allOf": [
            {
              "$ref": "#/$defs/Max35Text"
            }
          ]
        }
      },
      "description": "Name of the identification scheme. Either Code or Proprietary field value should be passed on request."
    },
    "FinancialInstitutionIdentification18": {
      "type": "object",
      "properties": {
        "bicfi": {
          "type": "object",
          "description": "Code allocated to a financial institution by the ISO 9362 Registration Authority as described in ISO 9362 Banking - Banking telecommunication messages - Business identifier code (BIC).",
          "allOf": [
            {
              "$ref": "#/$defs/BICFIDec2014Identifier"
            }
          ]
        },
        "ClrSysMmbId": {
          "type": "object",
          "description": "Information used to identify a member within a clearing system.",
          "allOf": [
            {
              "$ref": "#/$defs/ClearingSystemMemberIdentification2"
            }
          ]
        },
        "legal_entity": {
          "type": "object",
          "description": "Legal entity identification for the branch of the financialinstitution.",
          "allOf": [
            {
              "$ref": "#/$defs/LEIIdentifier"
            }
          ]
        },
        "name": {
          "type": "object",
          "description": "Name by which an agent is known and which is usually used to identify that agent.",
          "allOf": [
            {
              "$ref": "#/$defs/Max140Text"
            }
          ]
        },
        "postal_address": {
          "type": "object",
          "description": "Information that locates and identifies a specific address, as defined by postal services.",
          "allOf": [
            {
              "$ref": "#/$defs/PostalAddress24"
            }
          ]
        },
        "other": {
          "type": "object",
          "description": "Unique identification of an agent, as assigned by an institution, using an identification scheme.",
          "allOf": [
            {
              "$ref": "#/$defs/GenericFinancialIdentification1"
            }
          ]
        }
      }
    },
    "Frequency10Code": {
      "type": "string",
      "description": "Specifies the regularity of an event. NEVR - Event does never take place. YEAR - Event takes place every year or once a year. RATE - Event takes place based on a change of a rate. MIAN - Event takes place every six months or two times a year. QURT - Event takes place every three months or four times a year.",
      "enum": [
        "NEVR",
        "YEAR",
        "RATE",
        "MIAN",
        "QURT"
      ]
    },
    "Frequency36Choice": {
      "type": "object",
      "required": [
        "Prd",
        "point_in_time",
        "type"
      ],
      "properties": {
        "type": {
          "type": "object",
          "allOf": [
            {
              "$ref": "#/$defs/Frequency6Code"
            }
          ]
        },
        "Prd": {
          "type": "object",
          "description": "Defines a frequency in terms on counts per period for a specific period type.",
          "properties": {
            "type": {
              "type": "object",
              "description": "Period for which the number of instructions are to be created and processed.",
              "allOf": [
                {
                  "$ref": "#/$defs/Frequency6Code"
                }
              ]
            },
            "count_per_period": {
              "type": "string",
              "description": "Number of instructions to be created and processed during the specified period. Number of objects represented as a decimal number, for example 0.75 or 45.6. Fractional Digits up to 17 allowed.",
              "maxLength": 18
            }
          },
          "required": [
            "count_per_period",
            "type"
          ]
        },
        "point_in_time": {
          "type": "object",
          "allOf": [
            {
              "$ref": "#/$defs/FrequencyAndMoment1"
            }
          ]
        }
      },
      "description": "Regularity with which instructions are to be created and processed."
    },
    "Frequency37Choice": {
      "properties": {
        "code": {
          "type": "object",
          "description": "Specifies the regularity of an event. NEVR - Event does never take place. YEAR - Event takes place every year or once a year. RATE -Event takes place based on a change of a rate. MIAN - Event takes place every six months or two times a year. QURT - Event takes place every three months or four times a year.",
          "allOf": [
            {
              "$ref": "#/$defs/Frequency10Code"
            }
          ]
        },
        "proprietary": {
          "type": "string",
          "description": "Proprietary Details"
        }
      },
      "description": "Defines the category of adjustment.Either from Code or Proprietaryis Required."
    },
    "Frequency6Code": {
      "type": "string",
      "description": "Specifies the regularity of an event.<br><br><b>YEAR</b>: Event takes place every year or once a year. <br><br><b>MNTH</b>: Event takes placeevery month or once a month. <br><br><b>QURT</b>: Event takes place everythree months or four times a year. <br><br><b>MIAN</b>: Event takes placeevery six months or two times a year.<br><br><b>WEEK</b>: Event takes place once a week. <br><br><b>DAIL</b>: Event takes place every day. <br><br><b>ADHO</b>: Event takes place on request or as necessary. <br><br><b>INDA</b>: Event takes place several times a day. <br><br><b>FRTN</b>: Event takes place every two weeks.",
      "enum": [
        "YEAR",
        "MNTH",
        "QURT",
        "MIAN",
        "WEEK",
        "DAIL",
        "ADHO",
        "INDA",
        "FRTN"
      ]
    },
    "FrequencyAndMoment1": {
      "type": "object",
      "required": [
        "point_in_time",
        "type"
      ],
      "properties": {
        "type": {
          "type": "object",
          "allOf": [
            {
              "$ref": "#/$defs/Frequency6Code"
            }
          ]
        },
        "point_in_time": {
          "type": "string",
          "description": "Further information on the exact point in time the event should take place.",
          "pattern": "[0-9]{2}"
        }
      },
      "description": "Defines a frequency in terms a specific moment within a specified period type."
    },
    "GenericAccountIdentification1": {
      "type": "object",
      "required": [
        "Id"
      ],
      "properties": {
        "Id": {
          "type": "object",
          "description": "Identification assigned by an institution.",
          "allOf": [
            {
              "$ref": "#/$defs/Max34Text"
            }
          ]
        },
        "issuer": {
          "type": "object",
          "description": "Entity that assigns the identification.",
          "allOf": [
            {
              "$ref": "#/$defs/Max35Text"
            }
          ]
        },
        "SchmeNm": {
          "type": "object",
          "description": "Name of the identification scheme.",
          "allOf": [
            {
              "$ref": "#/$defs/AccountSchemeName1Choice"
            }
          ]
        }
      },
      "description": "Information related to a generic account identification."
    },
    "GenericFinancialIdentification1": {
      "type": "object",
      "required": [
        "identification"
      ],
      "properties": {
        "identification": {
          "type": "object",
          "description": "Unique and unambiguous identification of a person.",
          "allOf": [
            {
              "$ref": "#/$defs/Max35Text"
            }
          ]
        },
        "issuer": {
          "type": "object",
          "description": "Entity that assigns the identification.",
          "allOf": [
            {
              "$ref": "#/$defs/Max35Text"
            }
          ]
        },
        "scheme_name": {
          "type": "object",
          "allOf": [
            {
              "$ref": "#/$defs/FinancialIdentificationSchemeName1Choice"
            }
          ]
        }
      },
      "description": "Unique identification of an agent, as assigned by an institution, using an identification scheme."
    },
    "GenericIdentification30": {
      "type": "object",
      "required": [
        "identification",
        "issuer"
      ],
      "properties": {
        "identification": {
          "type": "string",
          "description": "Proprietary information, often a code, issued by the data source scheme issuer.",
          "pattern": "[a-zA-Z0-9]{4}"
        },
        "issuer": {
          "type": "string",
          "description": "Entity that assigns the identification.",
          "minLength": 1,
          "maxLength": 35
        },
        "scheme_name": {
          "type": "string",
          "description": "Short textual description of the scheme.",
          "minLength": 1,
          "maxLength": 35
        }
      }
    },
    "GenericOrganisationIdentification1": {
      "type": "object",
      "required": [
        "identification"
      ],
      "properties": {
        "identification": {
          "type": "object",
          "description": "Identification assigned by an institution.",
          "allOf": [
            {
              "$ref": "#/$defs/Max35Text"
            }
          ]
        },
        "scheme_name": {
          "type": "object",
          "description": "Name of the identif

# --- truncated at 32 KB (67 KB total) ---
# Full source: https://raw.githubusercontent.com/api-evangelist/citi/refs/heads/main/json-schema/citi-mandate-initiation-request-schema.json

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.
All 92 tools →

Call it yourself

curl for this page
This JSON Schema
curl "https://apis.io/api/v1/json-schemas/citi-mandate-initiation-request"
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.