Get all requests

get

https://api.seismic.com/programs/v2/spaces/{spaceId}/requests

Retrieves a list of requests within a space with extensive filtering capabilities including date ranges, assignees,
priorities, custom properties, and associations. This endpoint supports cursor-based pagination and flexible sorting
for building request management interfaces and reporting systems.

Key Features:

Supports multiple filtering criteria simultaneously for precise request queries
Provides cursor-based pagination for efficient large dataset retrieval
Offers flexible sorting options for optimal display ordering
Includes custom property filtering for advanced search capabilities
Returns complete request metadata including assignees, priorities, and associations
Supports filtering by program and content associations

Authorization Logic:

User must have a valid JWT token with viewing or management scopes
Token can be for either user or system operations for querying
Requests are filtered based on user's access permissions

Usage Example:
Retrieve all high-priority requests assigned to specific users within a date range for dashboard display and workload management.

Recent Requests

Time	Status	User Agent
Retrieving recent requests…

Loading…

Path Params

spaceId

string

required

length between 7 and 22

The unique identifier of the space containing the target entity. This determines the scope of entity queries and ensures proper access control. The space must be accessible to the authenticated user with appropriate permissions. It can be the unique identifier (GUID) of the space or the word "default" to indicate the default programs space. Common values include "default" and "rkr83lapKkyCJuLLWqLqzB".

Query Params

plannedEndDateFrom

date-time

Optional filter for requests with planned end date on or after this date (inclusive). Useful for finding
requests with upcoming or future deadlines.

plannedEndDateTo

date-time

Optional filter for requests with planned end date before this date (exclusive). Combine with plannedEndDateFrom
to define a specific date range for request deadlines.

plannedStartDateFrom

date-time

Optional filter for requests with planned start date on or after this date (inclusive). Helps identify requests
scheduled to begin within a specific timeframe.

plannedStartDateTo

date-time

Optional filter for requests with planned start date before this date (exclusive). Use with plannedStartDateFrom
to define a start date range.

createdAtFrom

date-time

Optional filter for requests created on or after this date (inclusive). Useful for tracking recently created
requests.

createdAtTo

date-time

Optional filter for requests created before this date (exclusive). Combine with createdAtFrom to define creation
date range.

updatedAtFrom

date-time

Optional filter for requests updated on or after this date (inclusive). Helps identify recently modified requests.

updatedAtTo

date-time

Optional filter for requests updated before this date (exclusive). Use with updatedAtFrom to define update date
range.

ids

array of strings

Optional array of request IDs to retrieve specific requests. When provided, only requests matching these IDs will
be returned.

ids

title

string

Optional keyword to search within request titles. Enables partial text matching for finding requests by name.

assigneeIds

array of strings

Optional array of user IDs to filter requests by assignee. Returns requests assigned to any of the specified users.

assigneeIds

priorities

array of strings

Optional array of priority values to filter requests. Available values: critical, high, medium, low.

priorities

keywords

string

Optional keyword to search within request titles and descriptions. Enables comprehensive text search across request
content.

assignerIds

array of strings

Optional array of user IDs to filter requests by assigner (the user who assigned the request).

assignerIds

creatorIds

array of strings

Optional array of user IDs to filter requests by creator (the user who created the request).

creatorIds

stepIds

array of int32s

Optional array of workflow step IDs to filter requests by their current workflow step.

stepIds

statusSchemaId

string

Optional status schema ID to filter requests using a specific status configuration.

cursor

string

Optional cursor for pagination. Use the cursor from the previous response to retrieve the next page of results.

limit

int32

Optional limit for number of requests to return per page. Defaults to 50 if not specified.

sort

array of strings

Optional array of sort criteria in format 'field:direction'. Supported fields: createdAt, updatedAt, plannedStartDate, plannedEndDate.

Supported directions: asc, desc.

sort

programId

string

Optional program ID to filter requests associated with a specific program. Use this parameter instead of the
deprecated projectId parameter.

hasProgram

boolean

Optional boolean to filter requests based on whether they are associated with any program. Use this parameter
instead of the deprecated hasProject parameter.

customProperties

object

Optional dictionary of custom property filters for advanced search using custom fields.

Filter Syntax:

customProperties[{propertyId}][operator]={operator} - Comparison operator
customProperties[{propertyId}][id]=%22{valueId}%22 - Filter by value ID (URL-encoded with %22)
customProperties[{propertyId}][value]=%22{value}%22 - Filter by value (URL-encoded with %22)

Example: customProperties[prop123][operator]=Contains&customProperties[prop123][value]=%22Marketing%22

followerIds

array of strings

Optional array of user IDs to filter requests by followers (users following the request for updates).

followerIds

associatedNodeIds

array of strings

Optional array of content node IDs to filter requests by associated content. Requests can only be associated
with content items, not programs or tasks.

associatedNodeIds

contentRefs

array of objects

Optional array of content reference objects to filter requests by specific content associations.

contentRefs

includeRequestFormCustomProperties

boolean

Defaults to false

Optional boolean to include request form custom properties in the response. Defaults to false for performance.

Responses

Language

Loading…

Response

Click Try It! to start a request and see the response here! Or choose an example:

application/json

200Requests retrieved successfully. Response includes request list and pagination metadata.

400Invalid request parameters. Common causes include malformed IDs, invalid date formats, or unsupported sort fields.

401Authentication failed due to missing, invalid, or expired JWT token. Obtain a valid token with required permission scopes.

403Access denied due to insufficient permissions to access entity or perform the requested action. Contact your administrator for assistance.

404Entity not found. Verify the entity ID exists to ensure proper permissions are granted.

500Internal server error during entity retrieval, mutation, or deletion.