Skip to main content

​
Overview

Search for event photos using a participant’s BIB number. Returns paginated image objects for the matching BIB, including large image URL, thumbnail URL, dimensions, and image ID.
BIB search must be enabled for the event. Check the bib_search flag from the Event Details endpoint before calling this.

​
Endpoint

GET /api/v1/ext/{org_id}/event/{event_id}/bibs/{bib}

​
Path Parameters

ParameterTypeRequiredDescription
org_idnumberYesYour organisation ID
event_idnumberYesThe event to search within
bibstringYesBIB number to search for (case-insensitive)

​
Query Parameters

ParameterTypeRequiredDescription
pagenumberNoPage number (default: 1)
page_sizenumberNoImages per page (default: 32, max: 100)
This endpoint returns paginated results. See the Pagination guide for details.

​
Example Request

curl -i \
  -H "X-API-Key: <your_9pic_api_key>" \
  "https://api.9pic.ai/api/v1/ext/903/event/456/bibs/1234?page=1&page_size=32"

​
Example Response (images found)

{
  "responseType": "success",
  "message": "Records for bib number 1234",
  "data": {
    "images": [
      {
        "img_url": "https://photos.9pic.ai/imgs/456/large/a4402318-0cf4-4e1e-b8e8-ac8e8f2fc244.jpg",
        "height": 4860,
        "widht": 3240,
        "image_id": "a4402318-0cf4-4e1e-b8e8-ac8e8f2fc244",
        "thumbanail_url": "https://photos.9pic.ai/imgs/456/small/a4402318-0cf4-4e1e-b8e8-ac8e8f2fc244.jpg",
        "orginal_url": null
      },
      {
        "img_url": "https://photos.9pic.ai/imgs/456/large/b5513429-1d05-5f2f-c9f9-bd9f9g3gd355.jpg",
        "height": 4860,
        "widht": 3240,
        "image_id": "b5513429-1d05-5f2f-c9f9-bd9f9g3gd355",
        "thumbanail_url": "https://photos.9pic.ai/imgs/456/small/b5513429-1d05-5f2f-c9f9-bd9f9g3gd355.jpg",
        "orginal_url": null
      }
    ],
    "pagination": {
      "total": 8,
      "currentPage": 1,
      "totalPages": 1,
      "hasNextPage": false,
      "hasPreviousPage": false,
      "page_size": 32
    }
  }
}

​
Example Response (no images)

{
  "responseType": "success",
  "message": "No images found",
  "data": {
    "images": [],
    "pagination": {
      "total": 0,
      "currentPage": 0,
      "totalPages": 0,
      "hasNextPage": false,
      "hasPreviousPage": false,
      "page_size": 32
    }
  }
}

​
Response Fields

FieldTypeDescription
responseTypestringAlways "success"
messagestringHuman-readable status message
data.imagesarrayList of image objects for the matched BIB
data.paginationobjectPagination metadata

​
Image Object

Each image object includes the large image URL, thumbnail URL, image ID, width, height, and orginal_url when directly available.
orginal_url is null in the standard BIB search response. Use Download Original Photos when you need access to original files.

​
Error Responses

StatusMeaning
401API key is missing
403API key is invalid, inactive, token/event ownership mismatch, or BIB search is disabled for this event
404Event configuration not found