---
updatedAt: 2026-06-30T16:05:49.000Z
agentTools:
  projectIndex: https://docs.datanomik.com/llms.txt
---

# Download Payment Receipt (PDF)

Downloads the payment receipt (PDF) by id (application/pdf). Role: ROLE_PAYMENTS_READ.

# OpenAPI definition

```json
{
  "openapi": "3.1.0",
  "info": {
    "title": "openbanking-api",
    "version": "1.0"
  },
  "servers": [
    {
      "url": "https://api.datanomik.com"
    }
  ],
  "components": {
    "securitySchemes": {
      "sec0": {
        "type": "http",
        "scheme": "basic"
      }
    }
  },
  "security": [
    {
      "sec0": []
    }
  ],
  "paths": {
    "/v1/payments/{paymentId}/receipt": {
      "get": {
        "responses": {
          "200": {
            "description": ""
          },
          "400": {
            "description": "Bad Request. Invalid or missing parameters/body, or a business rule that rejects the request.",
            "content": {
              "application/json": {
                "examples": {
                  "PAYMENT_OLDER_THAN_3_MONTHS": {
                    "value": "{\n    \"code\": 817,\n    \"type\": \"PAYMENT_OLDER_THAN_3_MONTHS\",\n    \"message\": \"Some of the selected payments are older than 3 months and will not be requested.\",\n    \"traceId\": \"0af7651916cd43dd8448eb211c80319c\"\n}"
                  },
                  "BEAN_VALIDATION_ERROR": {
                    "value": "{\n    \"code\": 402,\n    \"type\": \"BEAN_VALIDATION_ERROR\",\n    \"message\": \"Invalid arguments for specific request. Please check details to satisfy validations\",\n    \"traceId\": \"0af7651916cd43dd8448eb211c80319c\",\n    \"details\": [\n        \"linkId: must not be blank\"\n    ]\n}"
                  }
                },
                "schema": {
                  "type": "object",
                  "properties": {
                    "code": {
                      "type": "integer",
                      "example": 817
                    },
                    "type": {
                      "type": "string",
                      "example": "PAYMENT_OLDER_THAN_3_MONTHS"
                    },
                    "message": {
                      "type": "string",
                      "example": "Some of the selected payments are older than 3 months and will not be requested."
                    },
                    "traceId": {
                      "type": "string",
                      "example": "0af7651916cd43dd8448eb211c80319c"
                    },
                    "details": {
                      "type": "array",
                      "items": {
                        "type": "string"
                      },
                      "example": [
                        "linkId: must not be blank"
                      ]
                    }
                  }
                }
              }
            }
          },
          "401": {
            "description": "Unauthorized. Missing or invalid Basic Auth credentials.",
            "content": {
              "application/json": {
                "examples": {
                  "UNAUTHORIZED": {
                    "value": "{\n    \"code\": 401,\n    \"type\": \"UNAUTHORIZED\",\n    \"message\": \"Invalid credentials.\",\n    \"traceId\": \"0af7651916cd43dd8448eb211c80319c\"\n}"
                  }
                },
                "schema": {
                  "type": "object",
                  "properties": {
                    "code": {
                      "type": "integer",
                      "example": 401
                    },
                    "type": {
                      "type": "string",
                      "example": "UNAUTHORIZED"
                    },
                    "message": {
                      "type": "string",
                      "example": "Invalid credentials."
                    },
                    "traceId": {
                      "type": "string",
                      "example": "0af7651916cd43dd8448eb211c80319c"
                    }
                  }
                }
              }
            }
          },
          "403": {
            "description": "Forbidden. Source IP not whitelisted, credentials without the required scope, or trial period expired.",
            "content": {
              "application/json": {
                "examples": {
                  "IP_NOT_ALLOWED": {
                    "value": "{\n    \"code\": 632,\n    \"type\": \"IP_NOT_ALLOWED\",\n    \"message\": \"Source ip address not allowed.\",\n    \"traceId\": \"0af7651916cd43dd8448eb211c80319c\"\n}"
                  },
                  "FORBIDDEN": {
                    "value": "{\n    \"code\": 403,\n    \"type\": \"FORBIDDEN\",\n    \"message\": \"Forbidden\",\n    \"traceId\": \"0af7651916cd43dd8448eb211c80319c\"\n}"
                  }
                },
                "schema": {
                  "type": "object",
                  "properties": {
                    "code": {
                      "type": "integer",
                      "example": 632
                    },
                    "type": {
                      "type": "string",
                      "example": "IP_NOT_ALLOWED"
                    },
                    "message": {
                      "type": "string",
                      "example": "Source ip address not allowed."
                    },
                    "traceId": {
                      "type": "string",
                      "example": "0af7651916cd43dd8448eb211c80319c"
                    }
                  }
                }
              }
            }
          },
          "404": {
            "description": "Not Found. The referenced resource does not exist or does not belong to your workspace.",
            "content": {
              "application/json": {
                "examples": {
                  "PAYMENT_NOT_FOUND": {
                    "value": "{\n    \"code\": 782,\n    \"type\": \"PAYMENT_NOT_FOUND\",\n    \"message\": \"Payment resource not found.\",\n    \"traceId\": \"0af7651916cd43dd8448eb211c80319c\"\n}"
                  },
                  "MISSING_PAYMENT_RECEIPT": {
                    "value": "{\n    \"code\": 795,\n    \"type\": \"MISSING_PAYMENT_RECEIPT\",\n    \"message\": \"Payment Receipt resource not found.\",\n    \"traceId\": \"0af7651916cd43dd8448eb211c80319c\"\n}"
                  },
                  "FILE_NOT_FOUND": {
                    "value": "{\n    \"code\": 669,\n    \"type\": \"FILE_NOT_FOUND\",\n    \"message\": \"File not found.\",\n    \"traceId\": \"0af7651916cd43dd8448eb211c80319c\"\n}"
                  }
                },
                "schema": {
                  "type": "object",
                  "properties": {
                    "code": {
                      "type": "integer",
                      "example": 782
                    },
                    "type": {
                      "type": "string",
                      "example": "PAYMENT_NOT_FOUND"
                    },
                    "message": {
                      "type": "string",
                      "example": "Payment resource not found."
                    },
                    "traceId": {
                      "type": "string",
                      "example": "0af7651916cd43dd8448eb211c80319c"
                    }
                  }
                }
              }
            }
          },
          "500": {
            "description": "Internal Server Error. Unexpected error; report the `traceId` to support.",
            "content": {
              "application/json": {
                "examples": {
                  "INTERNAL_ERROR": {
                    "value": "{\n    \"code\": 500,\n    \"type\": \"INTERNAL_ERROR\",\n    \"message\": \"Unexpected error. Please contact support with the traceId.\",\n    \"traceId\": \"0af7651916cd43dd8448eb211c80319c\"\n}"
                  }
                },
                "schema": {
                  "type": "object",
                  "properties": {
                    "code": {
                      "type": "integer",
                      "example": 500
                    },
                    "type": {
                      "type": "string",
                      "example": "INTERNAL_ERROR"
                    },
                    "message": {
                      "type": "string",
                      "example": "Unexpected error. Please contact support with the traceId."
                    },
                    "traceId": {
                      "type": "string",
                      "example": "0af7651916cd43dd8448eb211c80319c"
                    }
                  }
                }
              }
            }
          }
        },
        "parameters": [
          {
            "in": "path",
            "name": "paymentId",
            "schema": {
              "type": "string"
            },
            "required": true,
            "description": "Payment identifier"
          }
        ],
        "summary": "Download Payment Receipt (PDF)",
        "operationId": "get_v1-payments-1",
        "description": "Downloads the payment receipt (PDF) by id (application/pdf). Role: ROLE_PAYMENTS_READ."
      }
    }
  },
  "x-readme": {
    "headers": [],
    "explorer-enabled": true,
    "proxy-enabled": true
  },
  "x-readme-fauxas": true
}
```