Skip to main content

Get Document Configurations

Method: GET
/api/v1/document-configurations


Description

This endpoint retrieves a list of document configurations based on various filters such as document type, country, uploader, and configuration name. It allows sorting and pagination for better control of results.


🔑 Authentication

This endpoint requires authentication via headers.

ParamValueType
tenantId{{tenantId}}string
userId{{userId}}string
countryCode{{countryCode}}string (optional)

Query Parameters

NameTypeDescription
documentUploadedBystringFilter by who uploaded the document (ALL, SELLER, BUYER, ADMIN).
byTradeTypestringFilter by trade type.
byCountrystringFilter by country.
byConfigNamestringFilter by document configuration name.
byDocumentCategoryIdsstringFilter by document category IDs.
documentConfigurationActivestringFilter by document configuration status (0 for inactive, 1 for active).
byDocumentTypestringFilter by document type (PRODUCT, TRADE), comma-separated if multiple.
orderstringSort results (ASC for ascending, DESC for descending).
pagestringSpecify the page number for paginated results.
limitstringSpecify the number of results per page.

Response: 200 OK

A successful response returns a list of document configurations.

Example Response:

[
{
"configId": "12345",
"configName": "Trade Documents",
"documentType": "TRADE",
"uploadedBy": "SELLER",
"country": "Nigeria",
"isActive": true,
"createdAt": "2025-02-12T10:00:00Z"
},
{
"configId": "67890",
"configName": "Product Documents",
"documentType": "PRODUCT",
"uploadedBy": "ADMIN",
"country": "Kenya",
"isActive": false,
"createdAt": "2025-01-15T12:00:00Z"
}
]

LANGUAGE

AUTHORIZATION

Bearer

CURL REQUEST


curl --request GET \ 
--url /api/v1/document-configurations \
--header 'accept: application/json' \
--header 'content-type: application/json'

RESPONSE


Click Try It! to start a request and see the response here!