Cerebro. разработчикам

Справочник API

Собран из openapi.json, который пишется из кода API: версия 1.0.0. Описания полей — на английском, как в самом описании.

Адрес: https://api.cerebro.uz. Каждый запрос несёт Authorization: Bearer sk_live_…. Вид отказа и общие правила — в быстром старте.

Осмотры · Survey(e)r

POST /v1/inspections Create an inspection
GET /v1/inspections List inspections
GET /v1/inspections/{id} Get an inspection

Create an inspection

POST /v1/inspections

Call after the policy has been paid. The answer carries the link to send to the client. Send Idempotency-Key so that a repeated request does not create a second inspection.

Parameters

idempotency-key header · string

Any unique string. A repeated request with the same key returns the inspection created the first time instead of creating another one.

Body

policyNumber string required

length 1–64

clientName string required

length 1–120

clientPhone string required

International format, for example +998901234567

^\+[0-9]{9,15}$

vehicle object required
make string required

length 1–60

model string required

length 1–60

year integer required

from 1950 ; to 2100

vin string required

17 characters, Latin capitals and digits, without I, O and Q

^[A-HJ-NPR-Z0-9]{17}$

plate string | null required

length 4–12

newWithoutPlates boolean required

default false

panoramicRoof boolean required

default false

marketPriceUsd number required

Market price as determined by the insurer. Used by the routing rules.

from 0.01 ; to 9999999999.99

salesChannel string required

site · partner · dealer · agent · office

unit string

The unit of the insurer the inspection belongs to, by its name as set up in the desk. Without it, the inspection takes the unit of the API key.

length 1–80

Answer · 201

id string · uuid required
number string required

e.g. "OSM-2026-000128"

status string required

created · capturing · submitted · prescreening · in_review · revision · rejection_pending · act_pending · dispute · callback · signed · rejected · unresolved · expired · delivered

clientStatus string required

awaiting_photos · under_review · retake_required · act_ready · passed · not_passed

policyNumber string required
clientName string required
clientPhone string required
vehicle object required
make string required

length 1–60

model string required

length 1–60

year integer required

from 1950 ; to 2100

vin string required

17 characters, Latin capitals and digits, without I, O and Q

^[A-HJ-NPR-Z0-9]{17}$

plate string | null required

length 4–12

newWithoutPlates boolean required

default false

panoramicRoof boolean required

default false

marketPriceUsd number required

Market price as determined by the insurer. Used by the routing rules.

from 0.01 ; to 9999999999.99

salesChannel string required

site · partner · dealer · agent · office

route string | null required

automatic · manual · senior_review

link object required
url string · uri required

Address to send to the client

expiresAt string · date-time required
revision integer required
createdAt string · date-time required
updatedAt string · date-time required

Refusals: 400 · 401 · 403 · 404 · 409

List inspections

GET /v1/inspections

Ordered by the time of the last change, oldest first. To follow changes, keep the updatedAt of the last inspection received and pass it as updatedSince.

Parameters

status query · string

created · capturing · submitted · prescreening · in_review · revision · rejection_pending · act_pending · dispute · callback · signed · rejected · unresolved · expired · delivered

updatedSince query · string
limit query · integer required
after query · string

The next of the previous page, as it was given.

Answer · 200

items object[] required
id string · uuid required
number string required

e.g. "OSM-2026-000128"

status string required

created · capturing · submitted · prescreening · in_review · revision · rejection_pending · act_pending · dispute · callback · signed · rejected · unresolved · expired · delivered

clientStatus string required

awaiting_photos · under_review · retake_required · act_ready · passed · not_passed

policyNumber string required
clientName string required
clientPhone string required
vehicle object required
make string required

length 1–60

model string required

length 1–60

year integer required

from 1950 ; to 2100

vin string required

17 characters, Latin capitals and digits, without I, O and Q

^[A-HJ-NPR-Z0-9]{17}$

plate string | null required

length 4–12

newWithoutPlates boolean required

default false

panoramicRoof boolean required

default false

marketPriceUsd number required

Market price as determined by the insurer. Used by the routing rules.

from 0.01 ; to 9999999999.99

salesChannel string required

site · partner · dealer · agent · office

route string | null required

automatic · manual · senior_review

link object required
url string · uri required

Address to send to the client

expiresAt string · date-time required
revision integer required
createdAt string · date-time required
updatedAt string · date-time required
next string | null required

Pass as after to get the next page. Null on the last page.

Refusals: 400 · 401 · 403 · 404 · 409

Get an inspection

GET /v1/inspections/{id}

Parameters

id path · string required

Answer · 200

id string · uuid required
number string required

e.g. "OSM-2026-000128"

status string required

created · capturing · submitted · prescreening · in_review · revision · rejection_pending · act_pending · dispute · callback · signed · rejected · unresolved · expired · delivered

clientStatus string required

awaiting_photos · under_review · retake_required · act_ready · passed · not_passed

policyNumber string required
clientName string required
clientPhone string required
vehicle object required
make string required

length 1–60

model string required

length 1–60

year integer required

from 1950 ; to 2100

vin string required

17 characters, Latin capitals and digits, without I, O and Q

^[A-HJ-NPR-Z0-9]{17}$

plate string | null required

length 4–12

newWithoutPlates boolean required

default false

panoramicRoof boolean required

default false

marketPriceUsd number required

Market price as determined by the insurer. Used by the routing rules.

from 0.01 ; to 9999999999.99

salesChannel string required

site · partner · dealer · agent · office

route string | null required

automatic · manual · senior_review

link object required
url string · uri required

Address to send to the client

expiresAt string · date-time required
revision integer required
createdAt string · date-time required
updatedAt string · date-time required

Refusals: 400 · 401 · 403 · 404 · 409

Результат осмотра

GET /v1/inspections/{id}/result Get the result
GET /v1/inspections/{id}/photos/{photoId} Download a photo
GET /v1/inspections/{id}/act Download the signed act
POST /v1/inspections/{id}/result/acknowledge Acknowledge receipt of the result

Get the result

GET /v1/inspections/{id}/result

Available once the inspection is signed, rejected or unresolved. Reading the result changes nothing; acknowledge receipt with a separate request.

Parameters

id path · string required

Answer · 200

inspection object required
id string · uuid required
number string required

e.g. "OSM-2026-000128"

status string required

created · capturing · submitted · prescreening · in_review · revision · rejection_pending · act_pending · dispute · callback · signed · rejected · unresolved · expired · delivered

clientStatus string required

awaiting_photos · under_review · retake_required · act_ready · passed · not_passed

policyNumber string required
clientName string required
clientPhone string required
vehicle object required
make string required

length 1–60

model string required

length 1–60

year integer required

from 1950 ; to 2100

vin string required

17 characters, Latin capitals and digits, without I, O and Q

^[A-HJ-NPR-Z0-9]{17}$

plate string | null required

length 4–12

newWithoutPlates boolean required

default false

panoramicRoof boolean required

default false

marketPriceUsd number required

Market price as determined by the insurer. Used by the routing rules.

from 0.01 ; to 9999999999.99

salesChannel string required

site · partner · dealer · agent · office

route string | null required

automatic · manual · senior_review

link object required
url string · uri required

Address to send to the client

expiresAt string · date-time required
revision integer required
createdAt string · date-time required
updatedAt string · date-time required
outcome string required

signed · rejected · unresolved

decision object required
route string | null required

automatic · manual · senior_review

ruleSetVersion integer | null required
ruleId string | null required
photos object[] required
id string · uuid required
kind string required

front · rear · left · right · roof · vin · odometer · license_front · license_back · registration_front · registration_back · panoramic_roof · damage_1 · damage_2 · damage_3

version integer required

Grows with every retake

current boolean required

False for a photo that was retaken later

sha256 string required

Checksum of the file

^[0-9a-f]{64}$

sizeBytes integer required
capturedAt string · date-time required
location object | null required
latitude number required
longitude number required
device string | null required
href string required

Address of the file, relative to the API root

history object[] required
at string · date-time required
actor object required
kind string required

client · staff · insurer_system · partner · system

id string | null required
action string required

e.g. "inspection.approve"

details object required
act object | null required
number string required

e.g. "AKT-2026-000128"

version integer required

Grows when a dispute changes the act

issuedAt string · date-time required
noDamage boolean required
damages object[] required
kind string required

e.g. "scratch"

part string required

e.g. "front_left_door"

photoId string · uuid required
comment string required
area object required

Place on the photo, as fractions of its width and height

x number required
y number required
width number required
height number required
signedAt string · date-time | null required
sha256 string | null required

Checksum of the signed PDF

href string | null required

Address of the signed PDF

readings object[] required

What was read from the photos in force. The mileage has no verdict.

kind string required

plate · vin · odometer

photoId string · uuid required
state string required

pending · done · failed

expected string | null required

The value stated in the request

value string | null required

The value read from the photo

confidence number | null required

from 0 ; to 1

verdict string | null required

match · close · mismatch · unreadable

signals object[] required

Signs that called for a closer look. Each carries details of its own.

code string required
parts string[] required

What the result carries. A part the insurer chose not to receive is left empty and is not named here.

collected boolean required

True once receipt has been acknowledged

filesRemovedAt string · date-time | null required

Set once the photos and the act were removed at the end of their term. The record stays; the files are answered with 410.

Refusals: 400 · 401 · 403 · 404 · 409

Download a photo

GET /v1/inspections/{id}/photos/{photoId}

The original file as the client sent it. Compare its SHA-256 with the sha256 given in the result to make sure the file arrived unchanged.

Parameters

id path · string required
photoId path · string required

Answer · 200

JPEG file

Refusals: 400 · 401 · 403 · 404 · 409

Download the signed act

GET /v1/inspections/{id}/act

The act as the client signed it, as a PDF. Compare its SHA-256 with act.sha256 given in the result.

Parameters

id path · string required

Answer · 200

PDF file

Refusals: 400 · 401 · 403 · 404 · 409

Acknowledge receipt of the result

POST /v1/inspections/{id}/result/acknowledge

Call after the act, the photos and the data have been saved in the policy record. The inspection becomes delivered. Repeating the call is safe.

Parameters

id path · string required

Answer · 200

id string · uuid required
number string required

e.g. "OSM-2026-000128"

status string required

created · capturing · submitted · prescreening · in_review · revision · rejection_pending · act_pending · dispute · callback · signed · rejected · unresolved · expired · delivered

clientStatus string required

awaiting_photos · under_review · retake_required · act_ready · passed · not_passed

policyNumber string required
clientName string required
clientPhone string required
vehicle object required
make string required

length 1–60

model string required

length 1–60

year integer required

from 1950 ; to 2100

vin string required

17 characters, Latin capitals and digits, without I, O and Q

^[A-HJ-NPR-Z0-9]{17}$

plate string | null required

length 4–12

newWithoutPlates boolean required

default false

panoramicRoof boolean required

default false

marketPriceUsd number required

Market price as determined by the insurer. Used by the routing rules.

from 0.01 ; to 9999999999.99

salesChannel string required

site · partner · dealer · agent · office

route string | null required

automatic · manual · senior_review

link object required
url string · uri required

Address to send to the client

expiresAt string · date-time required
revision integer required
createdAt string · date-time required
updatedAt string · date-time required

Refusals: 400 · 401 · 403 · 404 · 409

Убытки · Adjust(e)r

POST /v1/claims Report a loss
GET /v1/claims List losses
GET /v1/claims/{id} Get a loss
GET /v1/claims/{id}/result Get the result of a loss
GET /v1/claims/{id}/documents/{kind} Read a paper of a loss
POST /v1/claims/{id}/result/acknowledge Acknowledge receipt of the result

Report a loss

POST /v1/claims

Call when the client has reported an event under a casco policy: from the call centre, the site or the insurer’s own system. The answer carries the link the client is sent by SMS. From what the client told, the rules of the insurer propose a path; people hurt, a theft or a third party hand the loss to the usual process at once. Send Idempotency-Key so that a repeated request does not create a second loss.

Parameters

idempotency-key header · string

Any unique string. A repeated request with the same key returns the inspection created the first time instead of creating another one.

Body

policyNumber string required

length 1–64

clientName string required

length 1–120

clientPhone string required

International format, for example +998901234567

^\+[0-9]{9,15}$

language string

The language of the messages to the client. Uzbek unless said otherwise.

uz · ru

vehicle object required
make string required

length 1–60

model string required

length 1–60

year integer required

from 1950 ; to 2100

vin string required

17 characters, Latin capitals and digits, without I, O and Q

^[A-HJ-NPR-Z0-9]{17}$

plate string | null required

length 4–12

event object required
at string · date-time required

When the event happened

place string | null

length 1–200

thirdParties boolean required

Another vehicle or person was involved

default false

theft boolean required

default false

injuries boolean required

Somebody was hurt

default false

unit string

The unit of the insurer the loss belongs to, by its name as set up in the desk. Without it, the loss takes the unit of the API key.

length 1–80

Answer · 201

id string · uuid required
number string required

e.g. "UB-2026-000041"

status string required

opened · awaiting_photos · submitted · awaiting_visit · visit_assigned · estimating · approval_pending · offer_made · settling · settled · in_person · declined · stopped · expired · delivered

clientStatus string required

awaiting_photos · being_estimated · adjuster_on_the_way · offer_ready · being_paid · settled · with_insurer · expired

policyNumber string required
clientName string required
clientPhone string required
language string required

uz · ru

vehicle object required
make string required

length 1–60

model string required

length 1–60

year integer required

from 1950 ; to 2100

vin string required

17 characters, Latin capitals and digits, without I, O and Q

^[A-HJ-NPR-Z0-9]{17}$

plate string | null required

length 4–12

event object required
at string · date-time required
place string | null required
thirdParties boolean required
theft boolean required
injuries boolean required
path string | null required

remote · visit · in_person

proposedPath string | null required

remote · visit · in_person

pathReason string | null required

e.g. "small_loss"

offer object | null required
sumUzs number required

What the client is offered, in sums

estimateUzs number | null required
at string · date-time required
expiresAt string · date-time | null required
link object required
url string · uri required

Address to send to the client

expiresAt string · date-time required
revision integer required
createdAt string · date-time required
updatedAt string · date-time required

Refusals: 400 · 401 · 403 · 404 · 409

List losses

GET /v1/claims

Ordered by the time of the last change, oldest first. To follow changes, keep the updatedAt of the last loss received and pass it as updatedSince.

Parameters

status query · string

opened · awaiting_photos · submitted · awaiting_visit · visit_assigned · estimating · approval_pending · offer_made · settling · settled · in_person · declined · stopped · expired · delivered

updatedSince query · string
limit query · integer required
after query · string

The next of the previous page, as it was given.

Answer · 200

items object[] required
id string · uuid required
number string required

e.g. "UB-2026-000041"

status string required

opened · awaiting_photos · submitted · awaiting_visit · visit_assigned · estimating · approval_pending · offer_made · settling · settled · in_person · declined · stopped · expired · delivered

clientStatus string required

awaiting_photos · being_estimated · adjuster_on_the_way · offer_ready · being_paid · settled · with_insurer · expired

policyNumber string required
clientName string required
clientPhone string required
language string required

uz · ru

vehicle object required
make string required

length 1–60

model string required

length 1–60

year integer required

from 1950 ; to 2100

vin string required

17 characters, Latin capitals and digits, without I, O and Q

^[A-HJ-NPR-Z0-9]{17}$

plate string | null required

length 4–12

event object required
at string · date-time required
place string | null required
thirdParties boolean required
theft boolean required
injuries boolean required
path string | null required

remote · visit · in_person

proposedPath string | null required

remote · visit · in_person

pathReason string | null required

e.g. "small_loss"

offer object | null required
sumUzs number required

What the client is offered, in sums

estimateUzs number | null required
at string · date-time required
expiresAt string · date-time | null required
link object required
url string · uri required

Address to send to the client

expiresAt string · date-time required
revision integer required
createdAt string · date-time required
updatedAt string · date-time required
next string | null required

Pass as after to get the next page. Null on the last page.

Refusals: 400 · 401 · 403 · 404 · 409

Get a loss

GET /v1/claims/{id}

Parameters

id path · string required

Answer · 200

id string · uuid required
number string required

e.g. "UB-2026-000041"

status string required

opened · awaiting_photos · submitted · awaiting_visit · visit_assigned · estimating · approval_pending · offer_made · settling · settled · in_person · declined · stopped · expired · delivered

clientStatus string required

awaiting_photos · being_estimated · adjuster_on_the_way · offer_ready · being_paid · settled · with_insurer · expired

policyNumber string required
clientName string required
clientPhone string required
language string required

uz · ru

vehicle object required
make string required

length 1–60

model string required

length 1–60

year integer required

from 1950 ; to 2100

vin string required

17 characters, Latin capitals and digits, without I, O and Q

^[A-HJ-NPR-Z0-9]{17}$

plate string | null required

length 4–12

event object required
at string · date-time required
place string | null required
thirdParties boolean required
theft boolean required
injuries boolean required
path string | null required

remote · visit · in_person

proposedPath string | null required

remote · visit · in_person

pathReason string | null required

e.g. "small_loss"

offer object | null required
sumUzs number required

What the client is offered, in sums

estimateUzs number | null required
at string · date-time required
expiresAt string · date-time | null required
link object required
url string · uri required

Address to send to the client

expiresAt string · date-time required
revision integer required
createdAt string · date-time required
updatedAt string · date-time required

Refusals: 400 · 401 · 403 · 404 · 409

Get the result of a loss

GET /v1/claims/{id}/result

Available once the loss is settled, in_person, declined or stopped. Reading the result changes nothing; acknowledge receipt with a separate request.

Parameters

id path · string required

Answer · 200

claim object required
id string · uuid required
number string required

e.g. "UB-2026-000041"

status string required

opened · awaiting_photos · submitted · awaiting_visit · visit_assigned · estimating · approval_pending · offer_made · settling · settled · in_person · declined · stopped · expired · delivered

clientStatus string required

awaiting_photos · being_estimated · adjuster_on_the_way · offer_ready · being_paid · settled · with_insurer · expired

policyNumber string required
clientName string required
clientPhone string required
language string required

uz · ru

vehicle object required
make string required

length 1–60

model string required

length 1–60

year integer required

from 1950 ; to 2100

vin string required

17 characters, Latin capitals and digits, without I, O and Q

^[A-HJ-NPR-Z0-9]{17}$

plate string | null required

length 4–12

event object required
at string · date-time required
place string | null required
thirdParties boolean required
theft boolean required
injuries boolean required
path string | null required

remote · visit · in_person

proposedPath string | null required

remote · visit · in_person

pathReason string | null required

e.g. "small_loss"

offer object | null required
sumUzs number required

What the client is offered, in sums

estimateUzs number | null required
at string · date-time required
expiresAt string · date-time | null required
link object required
url string · uri required

Address to send to the client

expiresAt string · date-time required
revision integer required
createdAt string · date-time required
updatedAt string · date-time required
outcome string required

settled · in_person · declined · stopped

path string | null required

remote · visit · in_person

settingsVersion integer | null required
history object[] required
at string · date-time required
actor object required
kind string required

client · staff · insurer_system · partner · system

id string | null required
action string required

e.g. "inspection.approve"

details object required
collected boolean required

True once receipt has been acknowledged

documents object[] required

The act of the damage, the agreement, the receipt or the referral

kind string | string | string | string required
number string required
sha256 string required

SHA-256 of the PDF, hex

bytes integer required

Refusals: 400 · 401 · 403 · 404 · 409

Read a paper of a loss

GET /v1/claims/{id}/documents/{kind}

The act of the damage, the agreement, the receipt or the referral, as a PDF. The result of the loss lists which of them exist.

Parameters

id path · string required
kind path · string required

Answer · 200

A file

Refusals: 403 · 404

Acknowledge receipt of the result

POST /v1/claims/{id}/result/acknowledge

Call after the outcome has been saved in the claim file. The loss becomes delivered. Repeating the call is safe.

Parameters

id path · string required

Answer · 200

id string · uuid required
number string required

e.g. "UB-2026-000041"

status string required

opened · awaiting_photos · submitted · awaiting_visit · visit_assigned · estimating · approval_pending · offer_made · settling · settled · in_person · declined · stopped · expired · delivered

clientStatus string required

awaiting_photos · being_estimated · adjuster_on_the_way · offer_ready · being_paid · settled · with_insurer · expired

policyNumber string required
clientName string required
clientPhone string required
language string required

uz · ru

vehicle object required
make string required

length 1–60

model string required

length 1–60

year integer required

from 1950 ; to 2100

vin string required

17 characters, Latin capitals and digits, without I, O and Q

^[A-HJ-NPR-Z0-9]{17}$

plate string | null required

length 4–12

event object required
at string · date-time required
place string | null required
thirdParties boolean required
theft boolean required
injuries boolean required
path string | null required

remote · visit · in_person

proposedPath string | null required

remote · visit · in_person

pathReason string | null required

e.g. "small_loss"

offer object | null required
sumUzs number required

What the client is offered, in sums

estimateUzs number | null required
at string · date-time required
expiresAt string · date-time | null required
link object required
url string · uri required

Address to send to the client

expiresAt string · date-time required
revision integer required
createdAt string · date-time required
updatedAt string · date-time required

Refusals: 400 · 401 · 403 · 404 · 409