List my asks

curl --request GET \
  --url https://api.interchange.io/api/v2/asks \
  --header 'Authorization: Bearer <token>'

const options = {method: 'GET', headers: {Authorization: 'Bearer <token>'}};

fetch('https://api.interchange.io/api/v2/asks', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

{
  "generatedAt": "2023-11-07T05:31:56Z",
  "totalCount": 4503599627370495,
  "requests": [
    {
      "id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
      "title": "<string>",
      "blockedCustomerAction": "<string>",
      "createdAt": "2023-11-07T05:31:56Z",
      "updatedAt": "2023-11-07T05:31:56Z",
      "resolvedAt": "2023-11-07T05:31:56Z",
      "isActive": true,
      "isResolved": true,
      "statusLabel": "<string>",
      "statusDescription": "<string>",
      "nextUpdateAt": "2023-11-07T05:31:56Z",
      "isCustomerBlocked": true,
      "requester": {
        "note": "<string>",
        "updatedAt": "2023-11-07T05:31:56Z"
      },
      "resolution": {
        "releaseVersion": "<string>",
        "releasedAt": "2023-11-07T05:31:56Z",
        "whatChanged": "<string>",
        "requesterAction": "<string>",
        "delivery": {
          "channel": "<string>",
          "receipt": "<string>",
          "attempts": 4503599627370495,
          "deliveredAt": "2023-11-07T05:31:56Z"
        }
      }
    }
  ],
  "unavailableKinds": [],
  "hasMore": true,
  "nextCursor": "<string>",
  "supplyActions": [
    {
      "subjectName": "<string>",
      "classification": "<string>",
      "status": "<string>",
      "proposedAt": "2023-11-07T05:31:56Z"
    }
  ]
}

{
  "data": null,
  "error": {
    "code": "<string>",
    "message": "<string>",
    "field": "<string>",
    "details": {}
  }
}

{
  "data": null,
  "error": {
    "code": "<string>",
    "message": "<string>",
    "field": "<string>",
    "details": {}
  }
}

{
  "data": null,
  "error": {
    "code": "<string>",
    "message": "<string>",
    "field": "<string>",
    "details": {}
  }
}

Asks

List my asks

Everything the authenticated customer is waiting on Scope3 for, in one list. Read-only and scoped to the caller’s own account; there is no customer parameter. statusKey uses the same customer-safe vocabulary for every kind: received, accepted, in_progress, done, or closed. Internal workflow states and work-item identifiers never appear. Closing an issue or merging a pull request does not close a support, product, or commercial ask: explicitly linked work must appear in a verified production release. Supply and integration asks may also finish from their own customer-visible live-state evidence. Asks completed through a verified release remain observable for 90 days with their customer-safe resolution. When hasMore is true, pass nextCursor back as cursor to read the next page. When a source cannot be read, its kind appears in unavailableKinds so a degraded response is never mistaken for an empty list.

GET

asks

List my asks

curl --request GET \
  --url https://api.interchange.io/api/v2/asks \
  --header 'Authorization: Bearer <token>'

const options = {method: 'GET', headers: {Authorization: 'Bearer <token>'}};

fetch('https://api.interchange.io/api/v2/asks', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

{
  "generatedAt": "2023-11-07T05:31:56Z",
  "totalCount": 4503599627370495,
  "requests": [
    {
      "id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
      "title": "<string>",
      "blockedCustomerAction": "<string>",
      "createdAt": "2023-11-07T05:31:56Z",
      "updatedAt": "2023-11-07T05:31:56Z",
      "resolvedAt": "2023-11-07T05:31:56Z",
      "isActive": true,
      "isResolved": true,
      "statusLabel": "<string>",
      "statusDescription": "<string>",
      "nextUpdateAt": "2023-11-07T05:31:56Z",
      "isCustomerBlocked": true,
      "requester": {
        "note": "<string>",
        "updatedAt": "2023-11-07T05:31:56Z"
      },
      "resolution": {
        "releaseVersion": "<string>",
        "releasedAt": "2023-11-07T05:31:56Z",
        "whatChanged": "<string>",
        "requesterAction": "<string>",
        "delivery": {
          "channel": "<string>",
          "receipt": "<string>",
          "attempts": 4503599627370495,
          "deliveredAt": "2023-11-07T05:31:56Z"
        }
      }
    }
  ],
  "unavailableKinds": [],
  "hasMore": true,
  "nextCursor": "<string>",
  "supplyActions": [
    {
      "subjectName": "<string>",
      "classification": "<string>",
      "status": "<string>",
      "proposedAt": "2023-11-07T05:31:56Z"
    }
  ]
}

{
  "data": null,
  "error": {
    "code": "<string>",
    "message": "<string>",
    "field": "<string>",
    "details": {}
  }
}

{
  "data": null,
  "error": {
    "code": "<string>",
    "message": "<string>",
    "field": "<string>",
    "details": {}
  }
}

{
  "data": null,
  "error": {
    "code": "<string>",
    "message": "<string>",
    "field": "<string>",
    "details": {}
  }
}

Authorizations

Authorization

string

header

required

API key or access token

Query Parameters

limit

integer

default:10

Maximum asks to return, ordered by the most recent customer-visible update.

Required range: 1 <= x <= 25

cursor

string

Opaque cursor returned by the previous ask-list response.

Required string length: 1 - 512

Response

List my asks

generatedAt

string<date-time>

required

Pattern:

^(?:(?:\d\d[2468][048]|\d\d[13579][26]|\d\d0[48]|[02468][048]00|[13579][26]00)-02-29|\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\d|30)|(?:02)-(?:0[1-9]|1\d|2[0-8])))T(?:(?:[01]\d|2[0-3]):[0-5]\d(?::[0-5]\d(?:\.\d+)?)?(?:Z))$

totalCount

integer

required

Required range: 0 <= x <= 9007199254740991

requests

object[]

required

Show child attributes

unavailableKinds

enum<string>[]

Available options:

support,

product,

supply,

integration,

commercial

hasMore

boolean

nextCursor

string

Minimum string length: 1

supplyActions

object[] | null

Show child attributes

⌘I