---
title: "Retrive document on a specified entity"
method: POST
path: "/get-documents"
tags: ["Document"]
---

# Retrive document on a specified entity

`POST /get-documents`

` Use this endpoint to retrive document links and metadata attached to specific entities `

## Request body

- GetDocumentRequest
  - `entity` string
  - `entityId` string
  - `referenceNumbers` string[]
  - `type` string

## Response `200`

Status Code 200:  Successful Response - the request was successful!

- GetDocumentResponse
  - `count` number
  - `documents` object[]
    - `name` string
    - `createdAt` string
    - `signedUrl` string
    - `type` string
    - `status` string

## Other responses

- `400` — Status Code 400: Bad Request Response - the request header and/or body is invalid
- `500` — Status Code 500: Internal Server Error Response - there's a problem with the Public API service

---

[API](https://skmtc.net/cargomatic/apis/cargomatic-public-api.md) · [All operations](https://skmtc.net/cargomatic/apis/cargomatic-public-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/cargomatic/cargomatic-public-api/revisions/4aa7f4326443/schema)