---
updatedAt: 2025-02-14T21:02:12.000Z
agentTools:
  projectIndex: https://docs.kontempo.io/llms.txt
---

# Get Receipt by Pkey

Endpoint used by merchants for retrieving single receipt by pkey.

# OpenAPI definition

```json
{
  "openapi": "3.0.0",
  "paths": {
    "/v1/receipts/{receipt_id}": {
      "get": {
        "operationId": "ReceiptsController_getReceipt",
        "summary": "Get Receipt by Pkey",
        "description": "Endpoint used by merchants for retrieving single receipt by pkey.",
        "parameters": [
          {
            "name": "receipt_id",
            "required": true,
            "in": "path",
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "X-Api-Secret",
            "in": "header",
            "description": "Merchant Api Secret",
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "X-Api-Key",
            "in": "header",
            "description": "Merchant Api Key",
            "schema": {
              "type": "string"
            }
          }
        ],
        "responses": {
          "201": {
            "description": "",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Receipt"
                }
              }
            }
          },
          "500": {
            "description": "",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/InternalServerErrorErrorResponse"
                }
              }
            }
          }
        },
        "tags": [
          "Receipts"
        ]
      }
    }
  },
  "info": {
    "title": "Kontempo Merchant API",
    "description": "",
    "version": "1.0.0",
    "contact": {}
  },
  "servers": [
    {
      "url": "https://partners.kontempo.io"
    }
  ],
  "components": {
    "schemas": {
      "InternalServerErrorErrorResponse": {
        "type": "object",
        "properties": {
          "statusCode": {
            "type": "number",
            "example": 500
          },
          "message": {
            "type": "string"
          }
        },
        "required": [
          "statusCode",
          "message"
        ]
      },
      "Payment": {
        "type": "object",
        "properties": {
          "payment_id": {
            "type": "string"
          },
          "due_date": {
            "type": "number"
          },
          "amount_due": {
            "type": "number"
          },
          "amount_paid": {
            "type": "number"
          },
          "order_id": {
            "type": "string"
          },
          "external_order_id": {
            "type": "string"
          },
          "status": {
            "type": "string",
            "enum": [
              "new",
              "partial",
              "completed",
              "voided"
            ]
          }
        },
        "required": [
          "payment_id",
          "due_date",
          "amount_due",
          "amount_paid",
          "order_id",
          "external_order_id",
          "status"
        ]
      },
      "Receipt": {
        "type": "object",
        "properties": {
          "receipt_id": {
            "type": "string"
          },
          "merchant_account": {
            "type": "string"
          },
          "merchant_name": {
            "type": "string"
          },
          "buyer_account": {
            "type": "string"
          },
          "external_buyer_account": {
            "type": "string"
          },
          "buyer_name": {
            "type": "string"
          },
          "amount": {
            "type": "number"
          },
          "allocated_amount": {
            "type": "number"
          },
          "description": {
            "type": "string"
          },
          "payments": {
            "type": "array",
            "items": {
              "$ref": "#/components/schemas/Payment"
            }
          }
        },
        "required": [
          "receipt_id",
          "merchant_account",
          "merchant_name",
          "buyer_account",
          "external_buyer_account",
          "buyer_name",
          "amount",
          "allocated_amount",
          "description",
          "payments"
        ]
      }
    }
  },
  "x-readme": {
    "explorer-enabled": true,
    "proxy-enabled": true
  }
}
```