Skip to main content
GET
/
accounts
/
{accountId}
/
documents
List Documents
curl --request GET \
  --url https://api.rolla.xyz/api/v1/external/accounts/{accountId}/documents \
  --header 'X-API-Key: <api-key>'
{
  "success": true,
  "message": "Documents retrieved successfully",
  "data": [
    {
      "id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
      "applicationId": "<string>",
      "fileName": "<string>",
      "fileUrl": "<string>",
      "relatedPersonKey": "<string>",
      "created_at": "2023-11-07T05:31:56Z"
    }
  ]
}
Lists documents uploaded to an account’s application. Optionally filter by documentType.

​
Example Request

curl -X GET "https://api.rolla.xyz/api/v1/external/accounts/eec3cbed-79d8-4370-87a0-b6be9e287337/documents" \
  -H "X-API-Key: your_api_key_here"

​
Example Response

{
  "success": true,
  "message": "Documents retrieved successfully",
  "data": [
    {
      "id": "0c95b2a1-7a93-4a3a-9a52-2a1f0b9b3c11",
      "kyb_application_id": "fbb45236-881a-4c58-8954-22759499eab4",
      "document_type": "certificate_of_incorporation",
      "file_name": "certificate.pdf",
      "file_size": 248301,
      "mime_type": "application/pdf"
    },
    {
      "id": "1d06c3b2-8ba4-4b4b-8b63-3b201c0c4d22",
      "kyb_application_id": "fbb45236-881a-4c58-8954-22759499eab4",
      "document_type": "proof_of_address",
      "file_name": "utility_bill.pdf",
      "file_size": 102844,
      "mime_type": "application/pdf"
    }
  ]
}

Authorizations

​
X-API-Key
string
header
required

Your Rolla API key

Path Parameters

​
accountId
string<uuid>
required

Identifier of an account owned by the same user as your API key's business

Query Parameters

​
documentType
enum<string>
Available options:
certificate_of_incorporation,
articles_of_association,
proof_of_address,
director_register,
shareholder_register,
proof_of_tax_id,
bank_statement,
wolfsberg_questionnaire,
msb_flow_form,
flow_of_funds_diagram,
aml_policy_procedures,
ach_procedures,
wire_procedures,
customer_complaint_procedures,
prohibited_jurisdictions_industries

Response

Documents retrieved successfully

​
success
boolean
Example:

true

​
message
string
Example:

"Documents retrieved successfully"

​
data
object[]