Agency Extensions

Get Agency Capabilities

get

https://test.swooveapi.comhttps://live.swooveapi.com

/agency/capabilities/

Returns all capabilities related to the agency including item sizes, item weights, and vehicle types available.

Authorizations

BearerAuth

AuthorizationstringRequired

Bearer authentication header of the form Bearer <token>.

Responses

200

Success

application/json

successbooleanOptional

status of request true for success and false for failed request

Default: true

codeinteger · int32Optional

code for reason for failure

Default: 200

messagestringOptionalDefault: Estimate completed

400

Validation Error

application/json

500

Something went wrong

get

/agency/capabilities/

HTTPcURLJavaScriptPython

GET /agency/capabilities/ HTTP/1.1
Host: test.swooveapi.com
Authorization: Bearer YOUR_SECRET_TOKEN
Accept: */*

{
  "success": true,
  "code": 200,
  "message": "Estimate completed",
  "responses": {
    "itemSizes": [
      {
        "_id": "text",
        "name": "text",
        "code": "text",
        "description": "text",
        "unit": "text",
        "dimensions": {
          "length": 1,
          "width": 1,
          "height": 1
        },
        "logo": "https://example.com",
        "is_enabled": true,
        "agency_id": "text",
        "country_id": "text",
        "createdAt": "2026-03-21T03:33:45.288Z",
        "updatedAt": "2026-03-21T03:33:45.288Z"
      }
    ],
    "itemWeights": [
      {
        "_id": "text",
        "label": "text",
        "min_weight": 1,
        "max_weight": 1,
        "description": "text",
        "unit": "text",
        "is_enabled": true,
        "is_active": true,
        "agency_id": "text",
        "country_id": "text",
        "createdAt": "2026-03-21T03:33:45.288Z",
        "updatedAt": "2026-03-21T03:33:45.288Z"
      }
    ],
    "vehicleTypes": [
      {
        "_id": "text",
        "name": "text",
        "type": "MOTORCYCLE",
        "is_enabled": true,
        "agency_id": "text",
        "country_id": "text",
        "createdAt": "2026-03-21T03:33:45.288Z",
        "updatedAt": "2026-03-21T03:33:45.288Z"
      }
    ]
  }
}

Get Riders

get

https://test.swooveapi.comhttps://live.swooveapi.com

/agency/get-riders/

Returns a paginated list of riders (agents) created by the agency.

Authorizations

BearerAuth

AuthorizationstringRequired

Bearer authentication header of the form Bearer <token>.

Query parameters

page_numberintegerOptional

The current page number

Default: 1

limitsintegerOptional

Number of riders to return per page

Default: 10

active_deliveriesbooleanOptional

Filter for agents with active deliveries

Default: false

locationstringOptional

Comma-separated latitude and longitude to sort agents by proximity

Example: 5.6456,-0.1124

Responses

200

Success

application/json

successbooleanOptional

status of request true for success and false for failed request

Default: true

codeinteger · int32Optional

code for reason for failure

Default: 200

messagestringOptionalDefault: Estimate completed

400

Validation Error

application/json

401

Unauthorized

500

Something went wrong

get

/agency/get-riders/

HTTPcURLJavaScriptPython

GET /agency/get-riders/ HTTP/1.1
Host: test.swooveapi.com
Authorization: Bearer YOUR_SECRET_TOKEN
Accept: */*

{
  "success": true,
  "code": 200,
  "message": "Estimate completed",
  "responses": {
    "total": 1,
    "limit": 1,
    "page": 1,
    "pages": 1,
    "docs": [
      {
        "agent_first_name": "text",
        "agent_last_name": "text",
        "agent_mobile": "text",
        "agent_picture": "text",
        "license_type": "text",
        "license_number": "text",
        "license_expiry": 1
      }
    ]
  }
}