Retrieve supercession relationships

get

https://{env}.gainsystems.com/api/v1/inventory/supercessions

Returns supercession relationships: which new item supersedes which old items, and from when. See Master Data & Product Structure.

Recent Requests

Time	Status	User Agent
Retrieving recent requests…

Loading…

Query Params

NewItemCode

string

Return only relationships whose new (superseding) item is one of these codes. Up to 10 values, comma-separated with no spaces; each must match exactly.

NewLocationCode

string

Return only relationships whose new (superseding) location is one of these codes. Up to 10 values, comma-separated with no spaces; each must match exactly.

ItemLocationFilterType

string

include (default) returns only records matching the NewItemCode and NewLocationCode filters. exclude returns only records matching neither. Case-insensitive; any other value is rejected with 400.

EffectiveDateStart

string

Return only relationships that take effect on or after this date-time (inclusive), as YYYY-MM-DD HH:MM:SS

EffectiveDateEnd

string

Return only relationships that take effect before this date-time (exclusive), as YYYY-MM-DD HH:MM:SS

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

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