List Themes

GET 
/themes

Retrieves a paginated list of all themes created for the account

Request

Query Parameters

limit string

Default value: 50

GET /themes parameter

page string

Default value: 1

GET /themes parameter

order_by string

Possible values: [desc, asc]

GET /themes parameter

start_date date-time

Possible values: Value must match regular expression ^\d{4}-\d{2}-\d{2}(T\d{2}:\d{2}:\d{2}(\.\d+)?)?Z?$

YYYY-MM-DDTHH:mm:ss.sssZ

end_date date-time

Possible values: Value must match regular expression ^\d{4}-\d{2}-\d{2}(T\d{2}:\d{2}:\d{2}(\.\d+)?)?Z?$

YYYY-MM-DDTHH:mm:ss.sssZ

lookup_key string

The lookup key of the themes to return

Responses

200

GET /themes Successful response

application/json

Schema

Schema

version stringrequired

Possible values: [1.0]

The version of the response schema

result_type stringrequired

Possible values: [paginated_list]

A paginated list of the theme resource.

resource_type stringrequired

Possible values: [theme]

Data contains the theme resource.

data object[]required
The resource data
Array [
id cuidrequired
The unique identifier of the theme
resource_type stringrequired
Possible values: [theme]
logo objectrequired
The logo of the theme. This is displayed to the user in all communication and touch points.
version stringrequired
Possible values: [1.0]
The version of the response schema
result_type stringrequired
Possible values: [single]
A single object of the file resource.
resource_type stringrequired
Possible values: [file]
Data contains the file resource.
data objectrequired
The resource data.
id cuidrequired
The unique identifier of the file
resource_type stringrequired
Possible values: [file]
filename stringrequired
Possible values: non-empty
The complete filename including the file extension
mime_type stringrequired
Possible values: non-empty
The mime type of the file
url url
The signed read url of the file
metadata object
lookup_key stringrequired
A provided lookup key provided by you to help you identify the file.
created_at stringrequired
UTC datetime ISO string
updated_at stringrequired
UTC datetime ISO string
icon objectrequired
The icon of the theme. This is used for the favicon.
version stringrequired
Possible values: [1.0]
The version of the response schema
result_type stringrequired
Possible values: [single]
A single object of the file resource.
resource_type stringrequired
Possible values: [file]
Data contains the file resource.
data objectrequired
The resource data.
id cuidrequired
The unique identifier of the file
resource_type stringrequired
Possible values: [file]
filename stringrequired
Possible values: non-empty
The complete filename including the file extension
mime_type stringrequired
Possible values: non-empty
The mime type of the file
url url
The signed read url of the file
metadata object
lookup_key stringrequired
A provided lookup key provided by you to help you identify the file.
created_at stringrequired
UTC datetime ISO string
updated_at stringrequired
UTC datetime ISO string
primary_color string
Default value: #000000
The primary color used to create the color palette in the signing room.
metadata object
lookup_key stringrequired
A provided lookup key provided by you to help you identify the theme.
created_at stringrequired
UTC datetime ISO string
updated_at stringrequired
UTC datetime ISO string
]
pagination objectrequired

Contains the pagination meta data

limit int64required

Possible values: <= 9007199254740991

The maximum number of items per page

total_pages int64required

Possible values: <= 9007199254740991

The total number of pages

page int64required

Possible values: <= 9007199254740991

The current page number

total_results int64required

Possible values: <= 9007199254740991

The total number of results

Example (from schema)

{
  "version": "1.0",
  "result_type": "paginated_list",
  "resource_type": "theme",
  "data": [
    {
      "id": "cqztbapr1qfgric9izbexample",
      "resource_type": "theme",
      "logo": {
        "version": "1.0",
        "result_type": "single",
        "resource_type": "file",
        "data": {
          "id": "cdypzghb8xpdp4c6kgvexample",
          "resource_type": "file",
          "filename": "my-file.pdf",
          "mime_type": "application/pdf",
          "url": "https://zigned.se",
          "metadata": {
            "lookup_key": "file_tag"
          },
          "created_at": "2024-01-01T00:00:00.000Z",
          "updated_at": "2024-01-01T00:00:00.000Z"
        }
      },
      "icon": {
        "version": "1.0",
        "result_type": "single",
        "resource_type": "file",
        "data": {
          "id": "cdypzghb8xpdp4c6kgvexample",
          "resource_type": "file",
          "filename": "my-file.pdf",
          "mime_type": "application/pdf",
          "url": "https://zigned.se",
          "metadata": {
            "lookup_key": "file_tag"
          },
          "created_at": "2024-01-01T00:00:00.000Z",
          "updated_at": "2024-01-01T00:00:00.000Z"
        }
      },
      "primary_color": "#000000",
      "metadata": {
        "lookup_key": "your_internal_customer_id"
      },
      "created_at": "2024-01-01T00:00:00.000Z",
      "updated_at": "2024-01-01T00:00:00.000Z"
    }
  ],
  "pagination": {
    "limit": 100,
    "total_pages": 10,
    "page": 1,
    "total_results": 1000
  }
}

400

GET /themes Error response

application/json

Schema

Schema

status stringrequired

Possible values: [error]

error objectrequired
code int64required
Possible values: >= 400 and <= 599
message stringrequired
request_id uuidrequired

Example (from schema)

{
  "status": "error",
  "error": {
    "code": 0,
    "message": "string",
    "request_id": "3fa85f64-5717-4562-b3fc-2c963f66afa6"
  }
}

Loading...