Quickstart
Create an API key and make your first call.
Create a key
In Ingenee, open Settings → Organisation → API keys and click Create key. You need to be an organisation admin.
- Name it after the system that will use it, for example
CMS sync. - Choose a role. The key never does more than this role allows. Programmer suits most integrations.
- Tick the scopes it needs. For this quickstart, Library → Read is enough.
Copy the key when it appears. It starts with ik_live_ and is shown once.
Store it as a secret
export INGENEE_API_KEY="ik_live_…"Treat the key like a password: keep it on your server, not in a browser or mobile app.
List your titles
curl https://dev.app.ingenee.ai/api/v1/titles?limit=5 \
-H "Authorization: Bearer $INGENEE_API_KEY"{
"rows": [
{
"id": "1b478b6a-7721-4a94-aade-55c5658f259c",
"type": "movie",
"title": "The Long Night",
"status": "enriched",
"year": 2019,
"runtimeMinutes": 94,
"contentRating": "TV-14",
"language": "en",
"posterUrl": "https://image.tmdb.org/t/p/w500/…",
"genres": ["Thriller"],
"catalog": { "id": "0e578f59-bf28-455f-bc82-f0639a7575fb", "name": "Spring acquisitions" },
"updatedAt": "2026-10-29T18:36:29.063Z",
"createdAt": "2026-10-29T10:06:44.936Z"
}
],
"nextCursor": "eyJ1cGRhdGVkQXQiOiIyMDI2LTEwLTE1VDExOjQ1…"
}Read one title
curl https://dev.app.ingenee.ai/api/v1/titles/1b478b6a-7721-4a94-aade-55c5658f259c \
-H "Authorization: Bearer $INGENEE_API_KEY"The full title includes every field with its source, the field locks, images, genres, credits and, for a series, its seasons and episodes.
Next
- Authentication: scopes, roles and key lifecycle
- Pagination: walk the whole library and sync only what changed
- API reference: try any endpoint with your key