curl --request POST \
--url https://api.interchange.io/api/v2/storefront/account-mappings/reviews/{intakeId}/request-information \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data '
{
"message": "<string>",
"expiresAt": "2023-11-07T05:31:56Z"
}
'import requests
url = "https://api.interchange.io/api/v2/storefront/account-mappings/reviews/{intakeId}/request-information"
payload = {
"message": "<string>",
"expiresAt": "2023-11-07T05:31:56Z"
}
headers = {
"Authorization": "Bearer <token>",
"Content-Type": "application/json"
}
response = requests.post(url, json=payload, headers=headers)
print(response.text)const options = {
method: 'POST',
headers: {Authorization: 'Bearer <token>', 'Content-Type': 'application/json'},
body: JSON.stringify({message: '<string>', expiresAt: '2023-11-07T05:31:56Z'})
};
fetch('https://api.interchange.io/api/v2/storefront/account-mappings/reviews/{intakeId}/request-information', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));{
"id": "<string>",
"caseId": "<string>",
"status": "pending",
"message": "<string>",
"destinationUrl": "<string>",
"url": "<string>",
"expiresAt": "<string>",
"createdBy": "<string>",
"confirmedBy": "<string>",
"confirmedAt": "<string>",
"createdAt": "<string>"
}{
"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": {}
}
}{
"data": null,
"error": {
"code": "<string>",
"message": "<string>",
"field": "<string>",
"details": {}
}
}{
"data": null,
"error": {
"code": "<string>",
"message": "<string>",
"field": "<string>",
"details": {}
}
}Ask the buyer for information
Ask the buyer for information or an external action through the seller’s own process (AdCP account-setup dispositions §4.1). Mints a seller-scoped launch URL bound to this case and blocks the case on the buyer until the seller confirms arrival or the request expires.
curl --request POST \
--url https://api.interchange.io/api/v2/storefront/account-mappings/reviews/{intakeId}/request-information \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data '
{
"message": "<string>",
"expiresAt": "2023-11-07T05:31:56Z"
}
'import requests
url = "https://api.interchange.io/api/v2/storefront/account-mappings/reviews/{intakeId}/request-information"
payload = {
"message": "<string>",
"expiresAt": "2023-11-07T05:31:56Z"
}
headers = {
"Authorization": "Bearer <token>",
"Content-Type": "application/json"
}
response = requests.post(url, json=payload, headers=headers)
print(response.text)const options = {
method: 'POST',
headers: {Authorization: 'Bearer <token>', 'Content-Type': 'application/json'},
body: JSON.stringify({message: '<string>', expiresAt: '2023-11-07T05:31:56Z'})
};
fetch('https://api.interchange.io/api/v2/storefront/account-mappings/reviews/{intakeId}/request-information', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));{
"id": "<string>",
"caseId": "<string>",
"status": "pending",
"message": "<string>",
"destinationUrl": "<string>",
"url": "<string>",
"expiresAt": "<string>",
"createdBy": "<string>",
"confirmedBy": "<string>",
"confirmedAt": "<string>",
"createdAt": "<string>"
}{
"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": {}
}
}{
"data": null,
"error": {
"code": "<string>",
"message": "<string>",
"field": "<string>",
"details": {}
}
}{
"data": null,
"error": {
"code": "<string>",
"message": "<string>",
"field": "<string>",
"details": {}
}
}Authorizations
API key or access token
Path Parameters
Body
Ask the buyer for information or an external action through the seller's own process. Mints a seller-scoped launch URL bound to this case; the case blocks on the buyer until the seller confirms arrival or the request expires.
Bounded seller-authored plain-text message (1-2000 Unicode scalar values, <=8 KiB UTF-8). Newline and tab are the only permitted control characters; bidirectional overrides and markup are rejected. Treated as untrusted data and rendered as escaped text -- never instructions.
^(?:(?:\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))$The seller's own external process link (credit form, DocuSign, portal). Must be an absolute https URL with no credentials or control characters. Never rendered as setup.url on the wire -- offered by the launch page for an authorized human's explicit choice.
2048Response
Ask the buyer for information
pending, confirmed, superseded, cancelled The seller-scoped launch URL: {seller_agent_endpoint}/handoffs/{token}.