Create a fleet inspection

POST 
/fleets

Creates an active fleet inspection for the authenticated insurer. Personal fleets require proof of address and director identity documents. Corporate fleets require CAC, MEMART, and director identity documents.

Request

multipart/form-data

Body

required

name stringrequired

Possible values: >= 3 characters and <= 150 characters

Fleet name. Must be unique for the authenticated insurer.

inspection_type stringrequired

Possible values: [personal, corporate]

company_name stringrequired

Possible values: >= 3 characters

company_email emailrequired

Possible values: <= 100 characters

company_phone_no stringrequired
proof_of_address binary

Required for personal fleets. PNG, JPEG, or PDF with a maximum size of 1500 KB.

director_identity_card binaryrequired

Required for all fleets. PNG, JPEG, or PDF with a maximum size of 1500 KB.

cac_document binary

Required for corporate fleets. PNG, JPEG, or PDF with a maximum size of 1500 KB.

memart binary

Required for corporate fleets. PNG, JPEG, or PDF with a maximum size of 1500 KB.

Responses

201

Fleet inspection created successfully.

application/json

Schema

Schema

data object
uid string
Fleet ULID used in fleet API URLs.
id string
Alias of uid.
inspection_type string
Possible values: [personal, corporate]
name string
company_name string
company_phone_no string
company_email email
status string
payment_status string
policy_start_date datenullable
policy_end_date datenullable
meta object[]
Uploaded fleet documents. Returned by the get operation.
Array [
type string
url uri
file string
]
insurer object
Returned by the get operation.
id integer
code string
has_policies integer
Number of policies attached to the fleet.
vehicles_count integer
created_at date-time
inspection_link uri

Example (from schema)

{
  "data": {
    "uid": "01JZ7M5BCW8T2W4QWR5SN1MMBQ",
    "id": "01JZ7M5BCW8T2W4QWR5SN1MMBQ",
    "inspection_type": "personal",
    "name": "Delivery Fleet",
    "company_name": "Example Logistics Limited",
    "company_phone_no": "08012345678",
    "company_email": "fleet@example.com",
    "status": "active",
    "payment_status": "unpaid",
    "policy_start_date": "2026-08-03",
    "policy_end_date": "2026-08-03",
    "meta": [
      {
        "type": "string",
        "url": "string",
        "file": "string"
      }
    ],
    "insurer": {
      "id": 0,
      "code": "string"
    },
    "has_policies": 0,
    "vehicles_count": 0,
    "created_at": "2026-08-03T11:01:42.092Z",
    "inspection_link": "string"
  }
}

401

Unauthenticated - no valid API key was provided.

application/json

Schema

Schema

data string

Example (from schema)

{
  "data": "Invalid Token"
}

422

The request failed validation. Batch vehicle errors include the zero based request index, for example vehicles.1.chassis_number.

application/json

Schema

Schema

message stringrequired
error objectrequired
property name* string[]
Array [
string
]

Example (from schema)

{
  "message": "The chassis number must be a valid VIN.",
  "error": {
    "vehicles.1.chassis_number": [
      "The chassis number must be a valid VIN."
    ]
  }
}

429

Too many requests.

Loading...