> ## Documentation Index > Fetch the complete documentation index at: https://safepay.mintlify.site/llms.txt > Use this file to discover all available pages before exploring further. # Title Fetch V2 > Retrieve account title metadata for a conventional bank account number. Provide `account_number` and `bank_name`; Safepay resolves the receiver BIC internally before querying the Raast directory. Supported `bank_name` values and their BIC mappings are listed on this page. `bank_name` must match one of the supported snake\_case identifiers below. Unknown or misspelled bank names return a validation error. ### Supported `bank_name` values | bank\_name | BIC | | ------------------------------------------------- | ----------- | | allied\_bank\_ltd | ABPAPKKA | | accountant\_general\_pakistan\_revenue | AGPRPKKA | | summit\_bank\_limited | AHRBPKKA | | bank\_al\_falah\_limited | ALFHPKKA | | askari\_bank\_ltd | ASCMPKKA | | bank\_al\_habib\_ltd | BAHLPKKA | | bank\_of\_china | BKCHPKKA | | bank\_islami\_pakistan\_ltd | BKIPPKKA | | the\_bank\_of\_punjab | BPUNPKKA | | central\_depository\_co\_of\_pakistan | CDCPKKAA | | cga | CGAPKKAA | | citi\_bank\_n\_a | CITIPKKX | | deutsche\_bank\_ag | DEUTPKKA | | dubai\_islamic\_bank\_pak\_ltd | DUIBPKKA | | al\_baraka\_bank\_pakistan\_ltd | EGIBPKKA | | faysal\_bank\_limited | FAYSPKKA | | central\_directorate\_of\_national\_savings | FGCDNSZB | | finca\_microfinance\_bank | FINCAMFB | | hbl\_micro\_finance\_bank\_ltd | FMICFBPK | | first\_women\_bank\_limited | FWOMPKKA | | habib\_bank\_limited | HABBPKKARTG | | industrial\_and\_commercial\_bank\_of\_china\_ltd | ICBKPKKA | | js\_bank\_limited | JSBLPKKA | | khushali\_bank\_limited | KHBLDFID | | the\_bank\_of\_khyber\_ltd | KHYBPKKA | | samba\_bank\_limited | MBPLPKKA | | mcb\_islamic\_bank | MCIBPKKI | | meezan\_bank\_limited | MEZNPKKA | | habib\_metropolitan\_bank\_ltd | MPBLPKKA | | mcb\_bank\_ltd | MUCBPKKKRTG | | national\_bank\_of\_pakistan | NBPBPKKA | | apna\_microfinance\_bank\_ltd | NMICFBPK | | nrsp\_microfinance\_bank | NRSPMFBB | | silkbank\_limited | SAUDPKKA | | state\_bank\_of\_pakistan | SBPPPKKA | | standard\_chartered\_bank\_pakistan | SCBLPKKA | | sindh\_bank\_limited | SINDPKKA | | sme\_bank\_limited | SMESPKKA | | soneri\_bank\_ltd | SONEPKKA | | telenor\_micro\_finance\_bank\_limited | TMICFBPK | | uat\_participant | UATPKKHH | | u\_microfinance\_bank\_ltd | UMBLPKKA | | united\_bank\_limited | UNILPKKARTG | | mobilink\_micro\_finance\_bank\_ltd | WMBLPKKA | | zarai\_taraqiati\_bank\_ltd\_karachi | ZTBLPKKA | | nayapay | NPAYPKKA | | sadapay | SADAPKKA | | mashreq\_bank | MSHQPKKA | | rupin | RUPIPKKA | If you already have the beneficiary's IBAN, use [Title Fetch](/api-reference/utilities/title-fetch) instead. ## OpenAPI ````yaml get /v1/aggregators/{raast-aggregator-id}/title-fetch/v2 openapi: 3.1.0 info: title: Raast Wire version: 1.0.0 description: '' servers: - url: https://api.getsafepay.com/raastwire security: [] tags: - name: Aggregators - name: Access Keys - name: Merchants - name: Raast Merchants - name: Payments - name: Refunds - name: QRs - name: Utilities - name: Aliases - name: Ledgers - name: Webhooks - name: Settlement Operations - name: Settlement Reports paths: /v1/aggregators/{raast-aggregator-id}/title-fetch/v2: parameters: - $ref: '#/components/parameters/AggregatorIdParam' get: tags: - Utilities summary: Title Fetch V2 description: >- Retrieve account title metadata for a conventional bank account number. Provide `account_number` and `bank_name`; Safepay resolves the receiver BIC internally before querying the Raast directory. Supported `bank_name` values and their BIC mappings are listed on this page. parameters: - $ref: '#/components/parameters/TitleFetchV2AccountNumberParam' - $ref: '#/components/parameters/TitleFetchV2BankNameParam' responses: '200': $ref: '#/components/responses/TitleFetchResponse' '401': $ref: '#/components/responses/Unauthorized' security: - apiKey: [] components: parameters: AggregatorIdParam: name: raast-aggregator-id in: path required: true schema: type: string example: agg_2288490a-2176-4de5-b373-0ffb6f8e2e6e description: The unique identifier for the aggregator TitleFetchV2AccountNumberParam: name: account_number in: query required: true description: >- Conventional bank account number to fetch the registered account title for. schema: type: string example: '1007079203' example: '1007079203' TitleFetchV2BankNameParam: name: bank_name in: query required: true description: >- Snake_case identifier of the beneficiary's bank institution (e.g. `bank_al_falah_limited`). Must match one of the supported values listed on this page. Used to resolve the receiver BIC internally; unknown bank names return a validation error. schema: type: string example: bank_al_falah_limited example: bank_al_falah_limited responses: TitleFetchResponse: description: This response contains account title details fetched from Raast headers: Content-Length: $ref: '#/components/headers/ContentLengthHeader' Date: $ref: '#/components/headers/DateHeader' content: application/json: schema: allOf: - $ref: '#/components/schemas/StandardResponse' - type: object properties: data: $ref: '#/components/schemas/TitleFetchResult' examples: Title Fetch: value: api_version: v1 data: statusCode: 0 acctitle: Title-1 1007079203 acctype: Account Title Fetch V2: value: api_version: v1 data: statusCode: 0 acctitle: Title-1 1007079203 acctype: Account iban: PK91ALFH0005001007079203 Unauthorized: description: Unauthorized headers: Content-Length: $ref: '#/components/headers/ContentLengthHeader' Date: $ref: '#/components/headers/DateHeader' content: application/json: schema: $ref: '#/components/schemas/ApiErrorEnvelope' examples: Unauthorized: value: api_version: v1 error: code: error.unauthorized_access message: partner access key is required in request header headers: ContentLengthHeader: schema: type: string example: '256' DateHeader: schema: type: string example: Sat, 12 Aug 2023 08:55:04 GMT schemas: StandardResponse: type: object description: Standard response structure for successful operations properties: api_version: type: string example: v1 description: The current version of the API spec data: type: object description: Contains the response data TitleFetchResult: type: object description: Raast account title lookup result properties: statusCode: type: integer description: Numeric status code returned by the Raast directory acctitle: type: string description: Registered account title associated with the account acctype: type: string description: Classification of the account iban: type: string description: >- IBAN associated with the account when returned by the directory (for example, on conventional account lookups) ApiErrorEnvelope: type: object description: Error wrapper that includes the API version and error metadata properties: api_version: type: string description: Indicates the API version associated with the response example: v1 error: description: Structured error details describing why the request failed allOf: - $ref: '#/components/schemas/ErrorResponse' example: code: error.unauthorized_access message: partner access key is required in request header ErrorResponse: type: object description: Standard error response structure properties: code: type: string description: Error code identifying the type of error message: type: string description: Human-readable error message securitySchemes: apiKey: type: apiKey name: X-SFPY-AGGREGATOR-SECRET-KEY in: header ````