Generate Upload URL

Document Types

When generating upload URLs, specify one of the following document types:

Individual Identification:

• passport - Passport document
• national_id - National ID card
• proof_of_address - Proof of address document
• residence_permit - Residence permit

Legal Entity Identification:

• business_registry_extract - Business registry extract
• ubo_documentation - UBO (Ultimate Beneficial Owner) documentation
• ubo_passport - UBO passport
• authorised_person_passport - Authorized person passport

Source of Funds/Wealth:

• source_of_funds_document - Source of funds document
• source_of_wealth_document - Source of wealth document
• sof_supporting_document - Supporting document for source of funds
• sow_supporting_document - Supporting document for source of wealth

Transaction Documents:

• transaction_supporting_document - Supporting document for transaction
• registry_extract - Registry extract
• supporting_documents_of_relationship - Supporting documents for relationship

Other:

• other - Other document types

related_id Parameter

The related_id identifies the entity associated with the document:

• For RFI responses: Use the RFI ID (e.g., rfi_abc123xyz)
• For high-volume transfers: Use your legal entity ID. The transaction ID will be assigned automatically after transfer creation.

Example Requests

RFI Documents

curl -X POST "https://api.pavebank.com/v1/documents/upload-url" \
  --header "Authorization: Bearer YOUR_ACCESS_TOKEN" \
  --header "Content-Type: application/json" \
  --data '{
    "related_id": "rfi_abc123xyz",
    "content_type": "application/pdf",
    "document_type": "passport"
  }'

Transfer Documents

For transfers exceeding 100,000 GEL, use your legal entity ID as the related_id:

curl -X POST "https://api.pavebank.com/v1/documents/upload-url" \
  --header "Authorization: Bearer YOUR_ACCESS_TOKEN" \
  --header "Content-Type: application/json" \
  --data '{
    "related_id": "<LEGAL_ENTITY_ID>",
    "content_type": "application/pdf",
    "document_type": "transaction_supporting_document"
  }'

Example Response

{
    "id": "<DOCUMENT_ID>",
    "url": "https://storage.googleapis.com/pavebank-development-docs/<SIGNED_URL_WITH_PARAMETERS>",
    "expires_at": "2025-11-04T20:49:10.022639+08:00"
}

curl -X POST "https://developer-api-staging.pavebank.dev/v1/documents/upload-url" \
  -H "Authorization: Bearer <token>" \
  -H "Content-Type: application/json" \
  -d '{
    "related_id": "string",
    "content_type": "string",
    "document_type": "passport"
  }'

{
  "id": "string",
  "url": "string",
  "expires_at": "2019-08-24T14:15:22Z"
}