Anessa was previously called Insurely. You may still see the Insurely name in parts of our documentation while we complete the transition.

Routes

Get collections by user ID

GEThttps://api.insurely.com/users/{id}/collections

Returns all collections for the specified user within the client scope. Intended for backend-to-backend use with API key authentication.

Request

Path Parameters

idstring

The UUID of the user

Query Parameters

latestboolean

Return only the latest collection per company

statusInArray<string>

Filter by collection status (e.g. COMPLETED, FAILED)

Header Parameters

Insurely-Versionstring

The API version to use, as YYYY-MM-DD. Must match the version of the endpoint you are targeting. A request without it, or with a version older than the client's minimum API version, is served by the client's minimum API version.

Possible Enum values are 2026-04-01.

Responses

Collections retrieved successfully.

Body

collectionIdstring

Unique identifier for the collection.

companystring

Company identifier.

createdAtstring[date-time]

Timestamp when the collection was created.

loginMethodstring

Login method used for the collection.

Possible Enum values are USERNAME_AND_PASSWORD, PDF_UPLOAD, AUTHENTICATION_APP_URL or MANUAL_SELECT.
statusstring

Current status of the collection.

cURL
curl https://api.insurely.com/users/{id}/collections?latest=your-value&statusIn=your-value \
  -H "authorization-token: <authorization-token>" \
  -H "Insurely-Version: 2026-04-01"