> ## 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.

# Read Account Info

> Retrieve Raast account metadata using an IBAN or alias lookup



## OpenAPI

````yaml get /v1/aggregators/{raast-aggregator-id}/account-info
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
paths:
  /v1/aggregators/{raast-aggregator-id}/account-info:
    parameters:
      - $ref: '#/components/parameters/AggregatorIdParam'
    get:
      tags:
        - Utilities
      summary: Read Account Info
      description: Retrieve Raast account metadata using an IBAN or alias lookup
      parameters:
        - $ref: '#/components/parameters/AccountInfoIbanParam'
        - $ref: '#/components/parameters/AccountInfoWithTitleFetchParam'
        - $ref: '#/components/parameters/AccountInfoAliasTypeParam'
        - $ref: '#/components/parameters/AccountInfoAliasValueParam'
      responses:
        '200':
          $ref: '#/components/responses/AccountInfoResponse'
        '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
    AccountInfoIbanParam:
      name: iban
      in: query
      required: false
      description: >-
        IBAN to fetch account information for; optional when alias parameters
        are supplied.
      schema:
        type: string
        example: PK91ALFH0005001007079203
      example: PK91ALFH0005001007079203
    AccountInfoWithTitleFetchParam:
      name: with_title_fetch
      in: query
      required: false
      description: When true, include account title details in the response.
      schema:
        type: boolean
        example: true
      example: true
    AccountInfoAliasTypeParam:
      name: alias_type
      in: query
      required: false
      description: Alias type used for lookup; only MOBILE is supported currently.
      schema:
        type: string
        enum:
          - MOBILE
        example: MOBILE
      example: MOBILE
    AccountInfoAliasValueParam:
      name: alias_value
      in: query
      required: false
      description: Alias value to resolve; must be provided when alias_type is supplied.
      schema:
        type: integer
        example: 3472840476
      example: 3472840476
  responses:
    AccountInfoResponse:
      description: This response contains Raast account information details
      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/AccountInfo'
          examples:
            Account Info:
              value:
                api_version: v1
                data:
                  iban: PK91ALFH0005001007079203
                  type: CAS_CONST_UNSPECIFIED
                  currency: PKR
                  servicer_member_id: ALFHPKKA
                  name: MIRZA
                  is_default: false
                  dba: ''
                  mcc: ''
                  account_title: Title-1 1007079203
                  account_type: Account
    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
    AccountInfo:
      type: object
      description: Raast account metadata resolved by IBAN or alias lookup
      properties:
        iban:
          type: string
          description: IBAN associated with the account when available
        type:
          type: string
          description: Raast account classification code
        currency:
          type: string
          description: ISO 4217 currency code for the account
        servicer_member_id:
          type: string
          description: Member identifier of the servicing institution
        name:
          type: string
          description: Registered account holder name
        is_default:
          type: boolean
          description: Indicates if the account is the default for the merchant
        dba:
          type: string
          description: Doing-business-as name if present
        mcc:
          type: string
          description: Merchant category code associated with the account
        account_title:
          type: string
          description: Account title when title fetch is requested
        account_type:
          type: string
          description: Account type description returned from Raast
    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

````