KOC
Batch Operations

Batch retrieve KOL records by IDs with user account data

Retrieves KOL records in batches and checks for associated user accounts. If a user account exists, username and email from the users table will override the kols table data.

post/api/v1/koc/batch-kols

Request

  • Base URL: https://api.kolect.com
  • URL: https://api.kolect.com/api/v1/koc/batch-kols
  • Auth: HTTP bearer

Request body

kol_idsstring[] required

Array of KOL IDs to retrieve

batch_sizeinteger

Number of records to process per batch (max 200)

Example request

{
  "kol_ids": [
    "123e4567-e89b-12d3-a456-426614174000",
    "987fcdeb-51a2-43d7-b123-456789abcdef"
  ]
}

Response

Successfully retrieved KOL records

successboolean
total_requestedinteger

Total number of KOL IDs requested

total_foundinteger

Total number of KOL records found

total_batchesinteger

Number of batches processed

not_found_idsstring[]

Array of KOL IDs that were not found

processing_time_msinteger

Total processing time in milliseconds

Changes

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