List my asks

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

import requests

url = "https://api.interchange.io/api/v2/asks"

headers = {"Authorization": "Bearer <token>"}

response = requests.get(url, headers=headers)

print(response.text)

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": [
    {
      "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
    }
  ],
  "unavailableKinds": [],
  "hasMore": true,
  "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: support asks, product asks, and supply asks. Read-only, and scoped to the caller’s own account from the API key you call with — there is no customer parameter. statusKey is a closed, customer-safe vocabulary (received, accepted, in_progress, done, closed) that tracks the real work: a product ask follows the engineering work it is attached to, a supply ask follows that seller and channel through onboarding. Internal workflow state names never appear. statusLabel/statusDescription carry the wording to show. Which values a kind can reach differs: support reaches all five; a supply ask keeps a short recently-resolved window and reaches done (dated from the marketplace evidence that made it ready) but not closed, since nothing dates a cancellation; and a product ask reads the shared product projection’s open view, so it leaves the list on completion or cancellation instead of reporting a terminal status. When a source cannot be read its kind is listed in unavailableKinds, so a degraded answer is honest rather than an empty list that reads as “nothing open”.

GET

asks

List my asks

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

import requests

url = "https://api.interchange.io/api/v2/asks"

headers = {"Authorization": "Bearer <token>"}

response = requests.get(url, headers=headers)

print(response.text)

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": [
    {
      "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
    }
  ],
  "unavailableKinds": [],
  "hasMore": true,
  "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. Sources are round-robined so a large support queue cannot hide every product and supply ask at the limit.

Required range: 1 <= x <= 25

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

supplyActions

object[] | null

Show child attributes

Reject optimization suggestion Suggest requested supply

⌘I