Get all tasks

get

https://{env}.gainsystems.com/api/v1/tasks

Lists the tasks created by inbound submits and deletes, with their status and record counts. A 202 only means a batch was accepted: its records are applied once the task is Completed, and its Accepted and Rejected counts are filled in then. See Integration Tasks.

Recent Requests

Time	Status	User Agent
Retrieving recent requests…

Loading…

Query Params

Cursor

string

Opaque cursor identifying the page to return. Omit for the first page, then pass the NextCursor value from the previous response

Size

integer

1 to 1000

Defaults to 100

Maximum number of records to return in one page, from 1 to 1000. Default 100. On endpoints that group records under an item (for example, policies and forecasts), the limit applies to item/location records, so a page can return fewer top-level items than Size

Status

string

Return only tasks in these statuses, comma-separated: Received, Created, Queued, Processing, Completed, Failed, Cancelled, PendingReview, RejectedFailedProcessing, RejectedNotApproved. Case-insensitive; an unknown status is rejected with 400.

DateStart

string

Return only tasks created at or after this time. Format: YYYY-MM-DD HH:MM:SS, server time

DateEnd

string

Return only tasks created before this time (exclusive). Format: YYYY-MM-DD HH:MM:SS, server time

TaskType

string

Return only tasks of this type, for example InboundSku or DeleteSkuLocation. GET /api/v1/tasks/types lists every value

Headers

string

enum

Defaults to application/json

Generated from available response content types

Allowed:

Responses

Language

URL

Loading…

Response

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

*/*

application/json

200Request succeeded

400Malformed request, unknown field, or failed validation

401Credentials missing or not valid: a wrong user name or password, an invalid or expired token, or Basic credentials on an endpoint that accepts only a Bearer token

403Your credentials do not have the permission this endpoint requires, or the GAINS X connection is not enabled for your environment

426The connected GAINS X version does not support this endpoint. The body states the current version and the version required

500Unexpected server error

503GAINS is temporarily unavailable: GAINS X could not be reached or returned an error, a scheduled GAINS process is running, or your credentials could not be checked. Retry later

504GAINS X did not respond in time. Retry later