Roles

get

Authorizations

Basic

AuthorizationstringRequired

Query parameters

searchstringOptional

A search term.

orderingstringOptional

Which field to use when ordering the results.

role_typestring · enumOptional

role_type

Possible values:

is_primarystringOptional

is_primary

organizationstringOptional

organization

personstringOptional

person

pageintegerOptional

Page number to retrieve (1-indexed).

page_sizeintegerOptional

Number of results per page. Defaults to the pagination class's page size and respects the configured maximum.

Responses

200Success

application/json

get

/roles/

HTTPcURLJavaScriptPython

GET /public/roles/ HTTP/1.1
Host: app.rekap.com
Authorization: Basic username:password
Accept: */*

200Success

{
  "count": 1,
  "next": "https://example.com",
  "previous": "https://example.com",
  "results": [
    {
      "id": 1,
      "uuid": "123e4567-e89b-12d3-a456-426614174000",
      "title": "text",
      "organization": {
        "id": 1,
        "uuid": "123e4567-e89b-12d3-a456-426614174000",
        "name": "text",
        "type": "text",
        "archived": "2026-03-02T16:38:15.843Z"
      },
      "start_date": "2026-03-02",
      "end_date": "2026-03-02",
      "is_primary": true,
      "role_type": "employee"
    }
  ]
}

get

Authorizations

Basic

AuthorizationstringRequired

Path parameters

idstringRequired

Responses

200Success

application/json

get

/roles/{id}/

HTTPcURLJavaScriptPython

GET /public/roles/{id}/ HTTP/1.1
Host: app.rekap.com
Authorization: Basic username:password
Accept: */*

200Success

{
  "id": 1,
  "uuid": "123e4567-e89b-12d3-a456-426614174000",
  "title": "text",
  "organization": {
    "id": 1,
    "uuid": "123e4567-e89b-12d3-a456-426614174000",
    "name": "text",
    "type": "text",
    "archived": "2026-03-02T16:38:15.843Z"
  },
  "start_date": "2026-03-02",
  "end_date": "2026-03-02",
  "is_primary": true,
  "role_type": "employee",
  "person": {
    "id": 1,
    "uuid": "123e4567-e89b-12d3-a456-426614174000",
    "name": "text",
    "first_name": "text",
    "last_name": "text",
    "preferred_name": "text",
    "linkedin_url": "https://example.com",
    "phone": "text",
    "primary_work_email": "text",
    "primary_personal_email": "text",
    "archived": "2026-03-02T16:38:15.843Z",
    "created": "2026-03-02T16:38:15.843Z",
    "modified": "2026-03-02T16:38:15.843Z"
  },
  "relationship_contexts": [
    {
      "id": 1,
      "relationship": 1,
      "relationship_uuid": "123e4567-e89b-12d3-a456-426614174000",
      "relationship_role": "text",
      "description": "text",
      "created": "2026-03-02T16:38:15.843Z",
      "modified": "2026-03-02T16:38:15.843Z"
    }
  ],
  "created": "2026-03-02T16:38:15.843Z",
  "modified": "2026-03-02T16:38:15.843Z"
}