> ## 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 Raast Merchant > Explore a Raast merchant in detail. ## OpenAPI ````yaml get /v1/aggregators/{raast-aggregator-id}/raast-merchants/{raast-merchant-id} 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}/raast-merchants/{raast-merchant-id}: parameters: - $ref: '#/components/parameters/AggregatorIdParam' - $ref: '#/components/parameters/RaastMerchantIdParam' get: tags: - Raast Merchants summary: Read Raast Merchant description: Explore a Raast merchant in detail. responses: '200': $ref: '#/components/responses/FindRaastMerchantResponse' '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 RaastMerchantIdParam: name: raast-merchant-id in: path required: true schema: type: string example: mer_2cab1524-805d-4a09-8e51-924ddf3f43ea description: The unique identifier for the Raast merchant responses: FindRaastMerchantResponse: description: This response contains a single Raast merchant record 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/RaastMerchant' examples: FindRaastMerchantSecretKey: $ref: '#/components/examples/FindRaastMerchantSecretKey' 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 RaastMerchant: type: object description: Raast merchant profile synchronized from the state bank registry properties: id: type: string description: Internal Safepay identifier for the Raast merchant record token: type: string description: Public Raast merchant token partner_id: type: string description: Identifier of the upstream partner associated with the merchant raast_record_id: type: string description: Identifier issued by the Raast directory status: type: string description: Current activation status reported by Raast uid_type: type: string description: Type of the merchant unique identifier such as NTN or CNIC uid_value: type: string description: Value of the unique identifier registered with Raast name: type: string description: Legal entity name on file with Raast document_type: type: string description: Supporting document type recorded during onboarding document_number: type: string description: Number of the supporting document address_details: type: object description: Merchant registered address per Raast records properties: country: type: string description: ISO 3166-1 alpha-2 country code city: type: string description: City of the address state_province_region: type: string description: Province or region of the address address_line: type: string description: Street-level address line contact_details: type: object description: Merchant contact information on file properties: mobile_number: type: string description: Merchant contact mobile number in E.164 format email: type: string format: email description: Merchant contact email address additional_details: type: object description: Optional public metadata collected during onboarding properties: dba: type: string description: Doing-business-as name if different from the legal name mcc: type: string description: Merchant category code associated with the merchant lat: type: string description: Latitude coordinate when available long: type: string description: Longitude coordinate when available additional_details_private: type: object description: Safepay private metadata for the Raast merchant created_at: $ref: '#/components/schemas/Timestamp' updated_at: $ref: '#/components/schemas/Timestamp' 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 Timestamp: type: string format: date-time description: ISO 8601 timestamp in UTC example: '2025-03-13T09:12:34.000Z' 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 examples: FindRaastMerchantSecretKey: description: >- Example response when reading a Raast merchant using the secret key header value: api_version: v1 data: id: '32' token: mer_2cab1524-805d-4a09-8e51-924ddf3f43ea partner_id: partner_ed4f0480-36c8-4a5a-8cd4-381bc4d83f2c raast_record_id: '483177' status: Active uid_type: NTN uid_value: '33225247896001' name: Raast-Saphir-Merch document_type: NTN document_number: '33225247896001' address_details: country: PK city: Karachi state_province_region: Sindh address_line: h193c1 street contact_details: mobile_number: '+9233330226445' email: sapphire.bus@gmail.com additional_details: dba: The best business 101 mcc: '9032' lat: '' long: '' additional_details_private: {} created_at: '2025-09-12T07:06:06Z' updated_at: '2025-09-12T10:46:06Z' securitySchemes: apiKey: type: apiKey name: X-SFPY-AGGREGATOR-SECRET-KEY in: header ````