State Transition Logs

State change history and audit trail

List state transition logs

get

Returns a paginated list of state transition logs with comprehensive filtering options.

This endpoint provides audit trail information for all state changes in the system. Logs are automatically created whenever an object (Package, TransferOrder, etc.) transitions from one state to another.

Note: This is a read-only resource. Logs cannot be created, updated, or deleted via the API.

Authorizations

OmnitronPermission

AuthorizationstringRequired

JWT-based authentication required for all endpoints.

Include the token in the Authorization header: Authorization: Bearer <token>

Query parameters

formatstring · enumOptional

Response format (json, xml, etc.)

Default: jsonPossible values:

pageinteger · min: 1Optional

Page number for pagination

Default: 1

limitinteger · min: 1 · max: 100Optional

Number of items per page

Default: 10

sortstringOptional

Sort results by field. Prefix with '-' for descending order.

Available sort fields:

• id or -id
• created_date or -created_date
• modified_date or -modified_date

Default: -idExample: -created_date

old_stateintegerOptional

Filter by old state ID

Example: 1

new_stateintegerOptional

Filter by new state ID

Example: 2

old_state__namestringOptional

Filter by old state name (exact match)

Example: Waiting

new_state__namestringOptional

Filter by new state name (exact match)

Example: Preparing

old_state__enum_value__instringOptional

Filter by old state enum values (comma-separated list)

Example: 100,150

new_state__enum_value__instringOptional

Filter by new state enum values (comma-separated list)

Example: 200,300

object_idintegerOptional

Filter by related object ID

Example: 123

content_typeintegerOptional

Filter by content type ID

Example: 45

created_date__gtstring · date-timeOptional

Filter logs created after this date

Example: 2025-12-01T00:00:00Z

created_date__gtestring · date-timeOptional

Filter logs created on or after this date

Example: 2025-12-01T00:00:00Z

created_date__ltstring · date-timeOptional

Filter logs created before this date

Example: 2025-12-31T23:59:59Z

created_date__ltestring · date-timeOptional

Filter logs created on or before this date

Example: 2025-12-31T23:59:59Z

modified_date__gtstring · date-timeOptional

Filter logs modified after this date

Example: 2025-12-01T00:00:00Z

modified_date__gtestring · date-timeOptional

Filter logs modified on or after this date

Example: 2025-12-01T00:00:00Z

modified_date__ltstring · date-timeOptional

Filter logs modified before this date

Example: 2025-12-31T23:59:59Z

modified_date__ltestring · date-timeOptional

Filter logs modified on or before this date

Example: 2025-12-31T23:59:59Z

id__gtintegerOptional

Filter by ID greater than

Example: 1000

id__gteintegerOptional

Filter by ID greater than or equal to

Example: 1000

id__ltintegerOptional

Filter by ID less than

Example: 5000

id__lteintegerOptional

Filter by ID less than or equal to

Example: 5000

Responses

200

Successful operation

application/json

400

Bad request - invalid filter parameters

application/json

401

Unauthorized - authentication required

application/json

403

Forbidden - insufficient permissions

application/json

get

/state-transition-logs/

HTTPcURLJavaScriptPython

GET /api/v1/oms/state-transition-logs/ HTTP/1.1
Host: domain.akinon.com
Authorization: Bearer YOUR_SECRET_TOKEN
Accept: */*

{
  "count": 1250,
  "next": "/api/v1/oms/state-transition-logs/?page=2",
  "previous": null,
  "results": [
    {
      "id": 5432,
      "old_state": {
        "id": 1,
        "name": "Waiting",
        "enum_value": "100",
        "enum_class": "PackageStatus"
      },
      "new_state": {
        "id": 2,
        "name": "Preparing",
        "enum_value": "200",
        "enum_class": "PackageStatus"
      },
      "user": {
        "pk": 10,
        "first_name": "John",
        "last_name": "Doe",
        "email": "[email protected]",
        "username": "johndoe"
      },
      "attributes": {
        "command": {
          "slug": "PKG_STATE_TRANSITION",
          "transition_id": 50
        },
        "remote_user_pk": 789
      },
      "created_date": "2025-12-22T10:30:00.123456Z",
      "object_id": 123,
      "content_type": 45
    }
  ]
}

Get state transition log by ID

get

Retrieve a specific state transition log entry by its ID.

Returns detailed information about a single state change including the old state, new state, user who triggered the change, and additional metadata in the attributes field.

Authorizations

OmnitronPermission

AuthorizationstringRequired

JWT-based authentication required for all endpoints.

Include the token in the Authorization header: Authorization: Bearer <token>

Path parameters

idintegerRequired

Unique identifier of the state transition log

Example: 5432

Query parameters

formatstring · enumOptional

Response format (json, xml, etc.)

Default: jsonPossible values:

Responses

200

State transition log details

application/json

401

Unauthorized - authentication required

application/json

403

Forbidden - insufficient permissions

application/json

404

State transition log not found

application/json

get

/state-transition-logs/{id}/

HTTPcURLJavaScriptPython

GET /api/v1/oms/state-transition-logs/{id}/ HTTP/1.1
Host: domain.akinon.com
Authorization: Bearer YOUR_SECRET_TOKEN
Accept: */*

{
  "id": 5432,
  "old_state": {
    "id": 1,
    "name": "Waiting",
    "enum_value": "100",
    "enum_class": "PackageStatus"
  },
  "new_state": {
    "id": 2,
    "name": "Preparing",
    "enum_value": "200",
    "enum_class": "PackageStatus"
  },
  "user": {
    "pk": 10,
    "first_name": "John",
    "last_name": "Doe",
    "email": "[email protected]",
    "username": "johndoe"
  },
  "attributes": {
    "command": {
      "slug": "PKG_STATE_TRANSITION",
      "transition_id": 50
    },
    "remote_user_pk": 789,
    "remote_user_mail": "[email protected]"
  },
  "created_date": "2025-12-22T10:30:00.123456Z",
  "object_id": 123,
  "content_type": 45
}

List state transition logs (simple format)

get

Returns a list of state transition logs with minimal information without nested serializers.

This endpoint is useful for lightweight data retrieval when nested relationship data is not needed. Foreign key fields return only IDs instead of full nested objects, reducing response payload size.

Note: This endpoint does not use pagination by default.

Authorizations

OmnitronPermission

AuthorizationstringRequired

JWT-based authentication required for all endpoints.

Include the token in the Authorization header: Authorization: Bearer <token>

Query parameters

formatstring · enumOptional

Response format (json, xml, etc.)

Default: jsonPossible values:

sortstringOptional

Sort results by field. Prefix with '-' for descending order.

Available sort fields:

• id or -id
• created_date or -created_date
• modified_date or -modified_date

Default: -idExample: -created_date

old_stateintegerOptional

Filter by old state ID

Example: 1

new_stateintegerOptional

Filter by new state ID

Example: 2

object_idintegerOptional

Filter by related object ID

Example: 123

content_typeintegerOptional

Filter by content type ID

Example: 45

created_date__gtestring · date-timeOptional

Filter logs created on or after this date

Example: 2025-12-01T00:00:00Z

created_date__ltestring · date-timeOptional

Filter logs created on or before this date

Example: 2025-12-31T23:59:59Z

Responses

200

Successful operation

application/json

400

Bad request - invalid filter parameters

application/json

401

Unauthorized - authentication required

application/json

403

Forbidden - insufficient permissions

application/json

get

/state-transition-logs/simple/

HTTPcURLJavaScriptPython

GET /api/v1/oms/state-transition-logs/simple/ HTTP/1.1
Host: domain.akinon.com
Authorization: Bearer YOUR_SECRET_TOKEN
Accept: */*

[
  {
    "id": 5432,
    "created_date": "2025-12-22T10:30:00.123456Z",
    "modified_date": "2025-12-22T10:30:00.123456Z",
    "old_state": 1,
    "new_state": 2,
    "content_type": 45,
    "object_id": 123,
    "user": 10,
    "attributes": {
      "command": {
        "slug": "PKG_STATE_TRANSITION",
        "transition_id": 50
      }
    }
  },
  {
    "id": 5433,
    "created_date": "2025-12-22T11:15:00.654321Z",
    "modified_date": "2025-12-22T11:15:00.654321Z",
    "old_state": 15,
    "new_state": 16,
    "content_type": 52,
    "object_id": 456,
    "user": 25,
    "attributes": {
      "command": {
        "slug": "TRANSFER_STATE_TRANSITION",
        "transition_id": 75
      }
    }
  }
]