Skip to main content

​
Overview

BIB Search is the API surface for 9Pic BibTrack, our marathon BIB number recognition engine. Pass a participant’s BIB number and the API returns paginated image objects for the matching photos, including large image URL, thumbnail URL, dimensions, and image ID.
BIB search must be enabled for the event. Check the bib_search flag from Event Details 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 Model.

​
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

{
  "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,
        "width": 3240,
        "image_id": "a4402318-0cf4-4e1e-b8e8-ac8e8f2fc244",
        "thumbnail_url": "https://photos.9pic.ai/imgs/456/small/a4402318-0cf4-4e1e-b8e8-ac8e8f2fc244.jpg",
        "original_url": null
      },
      {
        "img_url": "https://photos.9pic.ai/imgs/456/large/b5513429-1d05-5f2f-c9f9-bd9f9g3gd355.jpg",
        "height": 4860,
        "width": 3240,
        "image_id": "b5513429-1d05-5f2f-c9f9-bd9f9g3gd355",
        "thumbnail_url": "https://photos.9pic.ai/imgs/456/small/b5513429-1d05-5f2f-c9f9-bd9f9g3gd355.jpg",
        "original_url": null
      }
    ],
    "pagination": {
      "total": 8,
      "currentPage": 1,
      "totalPages": 1,
      "hasNextPage": false,
      "hasPreviousPage": false,
      "page_size": 32
    }
  }
}

​
Response Models

ModelDescription
BibSearchResponseTop-level BIB search response envelope.
ImageItemImage object returned inside data.images[].
PaginationInfoPagination metadata returned inside data.pagination.
original_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.
429Rate limit exceeded. Back off and retry.
500Internal failure.
See Errors for canonical descriptions and retry guidance.