Get insta swap status
curl --request GET \
--url https://api.yourproducthere.ai/v1/insta-swaps/{id} \
--header 'Authorization: Bearer <token>'import requests
url = "https://api.yourproducthere.ai/v1/insta-swaps/{id}"
headers = {"Authorization": "Bearer <token>"}
response = requests.get(url, headers=headers)
print(response.text)const options = {method: 'GET', headers: {Authorization: 'Bearer <token>'}};
fetch('https://api.yourproducthere.ai/v1/insta-swaps/{id}', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));<?php
$curl = curl_init();
curl_setopt_array($curl, [
CURLOPT_URL => "https://api.yourproducthere.ai/v1/insta-swaps/{id}",
CURLOPT_RETURNTRANSFER => true,
CURLOPT_ENCODING => "",
CURLOPT_MAXREDIRS => 10,
CURLOPT_TIMEOUT => 30,
CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
CURLOPT_CUSTOMREQUEST => "GET",
CURLOPT_HTTPHEADER => [
"Authorization: Bearer <token>"
],
]);
$response = curl_exec($curl);
$err = curl_error($curl);
curl_close($curl);
if ($err) {
echo "cURL Error #:" . $err;
} else {
echo $response;
}package main
import (
"fmt"
"net/http"
"io"
)
func main() {
url := "https://api.yourproducthere.ai/v1/insta-swaps/{id}"
req, _ := http.NewRequest("GET", url, nil)
req.Header.Add("Authorization", "Bearer <token>")
res, _ := http.DefaultClient.Do(req)
defer res.Body.Close()
body, _ := io.ReadAll(res.Body)
fmt.Println(string(body))
}HttpResponse<String> response = Unirest.get("https://api.yourproducthere.ai/v1/insta-swaps/{id}")
.header("Authorization", "Bearer <token>")
.asString();require 'uri'
require 'net/http'
url = URI("https://api.yourproducthere.ai/v1/insta-swaps/{id}")
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
request = Net::HTTP::Get.new(url)
request["Authorization"] = 'Bearer <token>'
response = http.request(request)
puts response.read_body{
"instaSwap": {
"id": "e4e18374-f119-4b11-a8a1-d6a2bc38e41a",
"orgId": "org_123abc",
"digitalSampleId": "d3b07384-d113-4956-a5e2-416b2a41bc3c",
"actorId": "a1c02874-e339-4d11-8fa1-e6a2bc38c41d",
"accountToken": "creator_42",
"sampleAccountToken": "brand_nike",
"productToken": "sku_air_max_90",
"isBrandSelfService": false,
"status": "COMPLETED",
"triggerSource": "api",
"renderingMs": 4500,
"startedAt": "2026-06-20T12:10:00Z",
"finishedAt": "2026-06-20T12:10:04.500Z",
"signedResultVideoUrl": "https://r2.yourproducthere.ai/results/completed_video.mp4?token=sig",
"createdAt": "2026-06-20T12:09:59Z",
"updatedAt": "2026-06-20T12:10:05Z"
}
}{
"code": "UNAUTHORIZED",
"error": "Unauthorized"
}{
"code": "RESOURCE_NOT_FOUND",
"error": "insta swap not found"
}Insta Swaps
Get insta swap status
Retrieve the real-time status and telemetry of an individual insta swap task. Once the status transitions to COMPLETED, includes a temporary short-lived signedResultVideoUrl that is valid for 1 hour.
GET
/
insta-swaps
/
{id}
Get insta swap status
curl --request GET \
--url https://api.yourproducthere.ai/v1/insta-swaps/{id} \
--header 'Authorization: Bearer <token>'import requests
url = "https://api.yourproducthere.ai/v1/insta-swaps/{id}"
headers = {"Authorization": "Bearer <token>"}
response = requests.get(url, headers=headers)
print(response.text)const options = {method: 'GET', headers: {Authorization: 'Bearer <token>'}};
fetch('https://api.yourproducthere.ai/v1/insta-swaps/{id}', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));<?php
$curl = curl_init();
curl_setopt_array($curl, [
CURLOPT_URL => "https://api.yourproducthere.ai/v1/insta-swaps/{id}",
CURLOPT_RETURNTRANSFER => true,
CURLOPT_ENCODING => "",
CURLOPT_MAXREDIRS => 10,
CURLOPT_TIMEOUT => 30,
CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
CURLOPT_CUSTOMREQUEST => "GET",
CURLOPT_HTTPHEADER => [
"Authorization: Bearer <token>"
],
]);
$response = curl_exec($curl);
$err = curl_error($curl);
curl_close($curl);
if ($err) {
echo "cURL Error #:" . $err;
} else {
echo $response;
}package main
import (
"fmt"
"net/http"
"io"
)
func main() {
url := "https://api.yourproducthere.ai/v1/insta-swaps/{id}"
req, _ := http.NewRequest("GET", url, nil)
req.Header.Add("Authorization", "Bearer <token>")
res, _ := http.DefaultClient.Do(req)
defer res.Body.Close()
body, _ := io.ReadAll(res.Body)
fmt.Println(string(body))
}HttpResponse<String> response = Unirest.get("https://api.yourproducthere.ai/v1/insta-swaps/{id}")
.header("Authorization", "Bearer <token>")
.asString();require 'uri'
require 'net/http'
url = URI("https://api.yourproducthere.ai/v1/insta-swaps/{id}")
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
request = Net::HTTP::Get.new(url)
request["Authorization"] = 'Bearer <token>'
response = http.request(request)
puts response.read_body{
"instaSwap": {
"id": "e4e18374-f119-4b11-a8a1-d6a2bc38e41a",
"orgId": "org_123abc",
"digitalSampleId": "d3b07384-d113-4956-a5e2-416b2a41bc3c",
"actorId": "a1c02874-e339-4d11-8fa1-e6a2bc38c41d",
"accountToken": "creator_42",
"sampleAccountToken": "brand_nike",
"productToken": "sku_air_max_90",
"isBrandSelfService": false,
"status": "COMPLETED",
"triggerSource": "api",
"renderingMs": 4500,
"startedAt": "2026-06-20T12:10:00Z",
"finishedAt": "2026-06-20T12:10:04.500Z",
"signedResultVideoUrl": "https://r2.yourproducthere.ai/results/completed_video.mp4?token=sig",
"createdAt": "2026-06-20T12:09:59Z",
"updatedAt": "2026-06-20T12:10:05Z"
}
}{
"code": "UNAUTHORIZED",
"error": "Unauthorized"
}{
"code": "RESOURCE_NOT_FOUND",
"error": "insta swap not found"
}Authorizations
Your organization API key starting with yph_sk_live_…
Path Parameters
Response
Swap status details retrieved successfully
Insta swap render job. accountToken on the swap is the integrator id for whoever initiated it (creator or brand).
sampleAccountToken and productToken are read from the parent digital sample.
When isBrandSelfService is true, accountToken equals sampleAccountToken (brand-owned production, not a creator application).
Show child attributes
Show child attributes
Example:
{
"id": "e4e18374-f119-4b11-a8a1-d6a2bc38e41a",
"orgId": "org_123abc",
"digitalSampleId": "d3b07384-d113-4956-a5e2-416b2a41bc3c",
"actorId": "a1c02874-e339-4d11-8fa1-e6a2bc38c41d",
"accountToken": "creator_42",
"sampleAccountToken": "brand_nike",
"productToken": "sku_air_max_90",
"isBrandSelfService": false,
"status": "COMPLETED",
"triggerSource": "api",
"renderingMs": 4500,
"startedAt": "2026-06-20T12:10:00Z",
"finishedAt": "2026-06-20T12:10:04.500Z",
"signedResultVideoUrl": "https://r2.yourproducthere.ai/results/completed_video.mp4?token=sig",
"createdAt": "2026-06-20T12:09:59Z",
"updatedAt": "2026-06-20T12:10:05Z"
}
⌘I
