> ## 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. # Find QR > Explore a QR code in detail ## OpenAPI ````yaml get /v1/aggregators/{raast-aggregator-id}/qrs/{qr-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}/qrs/{qr-id}: parameters: - $ref: '#/components/parameters/AggregatorIdParam' - $ref: '#/components/parameters/QRIdParam' get: tags: - QRs summary: Find QR description: Explore a QR code in detail responses: '200': $ref: '#/components/responses/FindQRCodeResponse' '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 QRIdParam: name: qr-id in: path required: true schema: type: string example: qr_7e26f9be-f59d-4025-8e17-9fc398d16230 description: The unique identifier for the QR code responses: FindQRCodeResponse: description: This response contains details of a QR Code 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: type: object description: Container for the requested QR code resource. properties: qr_code: $ref: '#/components/schemas/QRCodeDetailed' required: - qr_code examples: StaticQR: $ref: '#/components/examples/FindQRStatic' DynamicQR: $ref: '#/components/examples/FindQRDynamic' 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 QRCodeDetailed: type: object description: >- Detailed QR code payload including EMVCo metadata for static and dynamic QR representations. properties: id: type: string description: Internal identifier assigned to the QR code record. token: type: string description: Public token referencing the QR code. aggregator_merchant_id: type: string description: Identifier of the aggregator merchant that owns the QR code. type: type: string description: Indicates whether the QR code is STATIC or DYNAMIC. code: type: string description: Complete EMVCo QR string that can be rendered for scanning. terminal_label: type: string description: Optional terminal label encoded in the QR code. reference_label: type: string description: Optional reference label encoded in the QR code. is_deleted: type: boolean description: Flag indicating whether the QR code has been revoked or deleted. code_details: allOf: - $ref: '#/components/schemas/EMVCoDetails' description: Parsed EMVCo details extracted from the QR string. created_at: allOf: - $ref: '#/components/schemas/Timestamp' description: Timestamp when the QR code was created. expired_at: allOf: - $ref: '#/components/schemas/Timestamp' description: Timestamp when the QR code expires, when applicable. 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 EMVCoDetails: type: object properties: payload_format_indicator: type: string point_of_initiation_method: type: string merchant_category_code: type: string transaction_currency: type: string transaction_amount: type: string country_code: type: string merchant_name: type: string merchant_city: type: string postal_code: type: string tip_or_convenience_indicator: type: string convenience_fixed_fee: type: string convenience_percentage_fee: type: string crc: type: string additional_data_field_template: type: object properties: bill_number: type: string store_label: type: string loyalty_label: type: string customer_label: type: string reference_label: type: string terminal_label: type: string transaction_purpose: type: string additional_consumer_request: type: string country_code: type: string rfu_for_emvco: type: array items: {} payment_system_specific: type: array items: {} merchant_information_language_template: nullable: true merchant_account_information: type: array items: type: object properties: tag: type: string value: type: object properties: globally_unique_identifier: type: object properties: tag: type: string value: type: string payment_network_specific: type: array items: type: object properties: tag: type: string value: type: string rfu_for_emvco: type: array items: {} unreserved_templates: type: array items: type: object properties: tag: type: string value: type: object properties: globally_unique_identifier: type: object properties: tag: type: string value: type: string context_specific_data: type: array items: type: object properties: tag: type: string value: type: string 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: FindQRStatic: description: Static QR code response example value: api_version: v1 data: qr_code: id: '47' token: qr_e46d5205-1e40-4d5f-943c-af90bd0d5670 aggregator_merchant_id: am_749fe6ce-91f9-4f6a-9df2-ec6ae9f75a30 type: STATIC code: >- 00020101021128760032749fe6ce91f94f6a9df2ec6ae9f75a300108SAFEPAYZ0224PK84HABB01640300501285945204563353035865802PK5912Lazer Sports6007Karachi62480520D19DKFNMVCT2M8CERIJ00720D19DKFNMVCT2M8CERIIG89360032e46d52051e404d5f943caf90bd0d567063040DCD terminal_label: D19DKFNMVCT2M8CERIIG reference_label: D19DKFNMVCT2M8CERIJ0 is_deleted: false created_at: '2025-06-18T15:24:46Z' code_details: payload_format_indicator: '01' point_of_initiation_method: '11' merchant_category_code: '5633' transaction_currency: '586' transaction_amount: '' country_code: PK merchant_name: Lazer Sports merchant_city: Karachi postal_code: '' tip_or_convenience_indicator: '' convenience_fixed_fee: '' convenience_percentage_fee: '' crc: 0DCD additional_data_field_template: bill_number: '' store_label: '' loyalty_label: '' customer_label: '' reference_label: D19DKFNMVCT2M8CERIJ0 terminal_label: D19DKFNMVCT2M8CERIIG transaction_purpose: '' additional_consumer_request: '' country_code: '' rfu_for_emvco: [] payment_system_specific: [] merchant_information_language_template: null merchant_account_information: - tag: '28' value: globally_unique_identifier: tag: '00' value: 749fe6ce91f94f6a9df2ec6ae9f75a30 payment_network_specific: - tag: '01' value: SAFEPAYZ - tag: '02' value: PK84HABB0164030050128594 rfu_for_emvco: [] unreserved_templates: - tag: '89' value: globally_unique_identifier: tag: '00' value: e46d52051e404d5f943caf90bd0d5670 context_specific_data: [] FindQRDynamic: description: Dynamic QR code response example value: api_version: v1 data: qr_code: id: '58' token: qr_7775775d-d4ba-4db9-ab92-2b9f252b0813 aggregator_merchant_id: am_749fe6ce-91f9-4f6a-9df2-ec6ae9f75a30 type: DYNAMIC code: >- 00020101021228760032b8319f0295b746968f99477bc0eaf3390108SAFEPAYZ0224PK84HABB016403005012859452045633530358654040.015802PK5912Lazer Sports6007Karachi62100506DQR10089360032b4a6d0a71a9a42e58793ae9acb9b19ac84760032b8319f0295b746968f99477bc0eaf3390136b4a6d0a7-1a9a-42e5-8793-ae9acb9b19ac63040870 terminal_label: '' reference_label: '' is_deleted: false created_at: '2025-06-23T06:47:08Z' code_details: payload_format_indicator: '01' point_of_initiation_method: '12' merchant_category_code: '5633' transaction_currency: '586' transaction_amount: '0.01' country_code: PK merchant_name: Lazer Sports merchant_city: Karachi postal_code: '' tip_or_convenience_indicator: '' convenience_fixed_fee: '' convenience_percentage_fee: '' crc: '0870' additional_data_field_template: bill_number: '' store_label: '' loyalty_label: '' customer_label: '' reference_label: DQR100 terminal_label: '' transaction_purpose: '' additional_consumer_request: '' country_code: '' rfu_for_emvco: [] payment_system_specific: [] merchant_information_language_template: null merchant_account_information: - tag: '28' value: globally_unique_identifier: tag: '00' value: b8319f0295b746968f99477bc0eaf339 payment_network_specific: - tag: '01' value: SAFEPAYZ - tag: '02' value: PK84HABB0164030050128594 rfu_for_emvco: [] unreserved_templates: - tag: '89' value: globally_unique_identifier: tag: '00' value: b4a6d0a71a9a42e58793ae9acb9b19ac context_specific_data: [] - tag: '84' value: globally_unique_identifier: tag: '00' value: b8319f0295b746968f99477bc0eaf339 context_specific_data: - tag: '01' value: b4a6d0a7-1a9a-42e5-8793-ae9acb9b19ac securitySchemes: apiKey: type: apiKey name: X-SFPY-AGGREGATOR-SECRET-KEY in: header ````