Documents

Upload a document

To upload a file to Column, you will need to send a request with Content-Type: multipart/form-data. The request should contain the file you would like to upload, as well as other metadata. The type field cannot be card_dispute_evidence: card dispute evidence documents are uploaded via POST /issuing/card-disputes/documents.

post/documents

Request

  • Base URL: https://api.column.com
  • URL: https://api.column.com/documents
  • Auth: HTTP basic

Headers

Idempotency-Keystring

Idempotency keys can be up to 255 characters long and are case sensitive. Column reserves the right to expire idempotency keys after 30 days. Only ASCII printable characters (code 32 - 126) are allowed for idempotency keys.

Response

Successful response

checksumstring required

The SHA-256 checksum of the uploaded document

created_atstring date-time required

Timestamp at which the document was created in the Column system

descriptionstring required

Description of the document provided when the document was created

idstring required

The unique id of this object

sizeinteger required

The file size in bytes

tagstring required

The tag of the document

typestring required

The type of document

updated_atstring date-time required

The timestamp the document was updated

urlstring required

URL to download the document. Expires after 60 seconds.

Example response

{
  "description": "Receipt for order 2024-001",
  "id": "docu_2x8gszy5folpA9s0TOCseE9ABDM",
  "size": 204800,
  "type": "other",
  "url": "https://example.com/documents/receipt.pdf"
}

Changes

No recorded changes to this operation across all 1 revision of this API.