Delist a card
curl --request DELETE \
--url https://catchbackcards.com/api/partner/v1/listings \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data '
{
"card_id": "0e94dc61-5a2f-4b1e-9c3d-7f8a1b2c3d4e"
}
'import requests
url = "https://catchbackcards.com/api/partner/v1/listings"
payload = { "card_id": "0e94dc61-5a2f-4b1e-9c3d-7f8a1b2c3d4e" }
headers = {
"Authorization": "Bearer <token>",
"Content-Type": "application/json"
}
response = requests.delete(url, json=payload, headers=headers)
print(response.text)const options = {
method: 'DELETE',
headers: {Authorization: 'Bearer <token>', 'Content-Type': 'application/json'},
body: JSON.stringify({card_id: '0e94dc61-5a2f-4b1e-9c3d-7f8a1b2c3d4e'})
};
fetch('https://catchbackcards.com/api/partner/v1/listings', 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://catchbackcards.com/api/partner/v1/listings",
CURLOPT_RETURNTRANSFER => true,
CURLOPT_ENCODING => "",
CURLOPT_MAXREDIRS => 10,
CURLOPT_TIMEOUT => 30,
CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
CURLOPT_CUSTOMREQUEST => "DELETE",
CURLOPT_POSTFIELDS => json_encode([
'card_id' => '0e94dc61-5a2f-4b1e-9c3d-7f8a1b2c3d4e'
]),
CURLOPT_HTTPHEADER => [
"Authorization: Bearer <token>",
"Content-Type: application/json"
],
]);
$response = curl_exec($curl);
$err = curl_error($curl);
curl_close($curl);
if ($err) {
echo "cURL Error #:" . $err;
} else {
echo $response;
}package main
import (
"fmt"
"strings"
"net/http"
"io"
)
func main() {
url := "https://catchbackcards.com/api/partner/v1/listings"
payload := strings.NewReader("{\n \"card_id\": \"0e94dc61-5a2f-4b1e-9c3d-7f8a1b2c3d4e\"\n}")
req, _ := http.NewRequest("DELETE", url, payload)
req.Header.Add("Authorization", "Bearer <token>")
req.Header.Add("Content-Type", "application/json")
res, _ := http.DefaultClient.Do(req)
defer res.Body.Close()
body, _ := io.ReadAll(res.Body)
fmt.Println(string(body))
}HttpResponse<String> response = Unirest.delete("https://catchbackcards.com/api/partner/v1/listings")
.header("Authorization", "Bearer <token>")
.header("Content-Type", "application/json")
.body("{\n \"card_id\": \"0e94dc61-5a2f-4b1e-9c3d-7f8a1b2c3d4e\"\n}")
.asString();require 'uri'
require 'net/http'
url = URI("https://catchbackcards.com/api/partner/v1/listings")
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
request = Net::HTTP::Delete.new(url)
request["Authorization"] = 'Bearer <token>'
request["Content-Type"] = 'application/json'
request.body = "{\n \"card_id\": \"0e94dc61-5a2f-4b1e-9c3d-7f8a1b2c3d4e\"\n}"
response = http.request(request)
puts response.read_body{
"card_id": "0e94dc61-…",
"delisted": true
}{
"error": "<string>",
"code": "<string>"
}{
"error": "Missing or malformed API key"
}{
"error": "<string>",
"code": "<string>"
}{
"error": "<string>",
"code": "<string>"
}{
"error": "<string>",
"code": "<string>"
}{
"error": "<string>",
"code": "<string>"
}Marketplace
Delist a card
Scope: write:listings (needs a linked account). Changes data.
Takes a listing down, and the card returns to your vault. This runs none of the seller checks that listing does, so an account that can no longer list can still take its listings down. The card goes in a JSON body, not the URL.
DELETE
/
api
/
partner
/
v1
/
listings
Delist a card
curl --request DELETE \
--url https://catchbackcards.com/api/partner/v1/listings \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data '
{
"card_id": "0e94dc61-5a2f-4b1e-9c3d-7f8a1b2c3d4e"
}
'import requests
url = "https://catchbackcards.com/api/partner/v1/listings"
payload = { "card_id": "0e94dc61-5a2f-4b1e-9c3d-7f8a1b2c3d4e" }
headers = {
"Authorization": "Bearer <token>",
"Content-Type": "application/json"
}
response = requests.delete(url, json=payload, headers=headers)
print(response.text)const options = {
method: 'DELETE',
headers: {Authorization: 'Bearer <token>', 'Content-Type': 'application/json'},
body: JSON.stringify({card_id: '0e94dc61-5a2f-4b1e-9c3d-7f8a1b2c3d4e'})
};
fetch('https://catchbackcards.com/api/partner/v1/listings', 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://catchbackcards.com/api/partner/v1/listings",
CURLOPT_RETURNTRANSFER => true,
CURLOPT_ENCODING => "",
CURLOPT_MAXREDIRS => 10,
CURLOPT_TIMEOUT => 30,
CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
CURLOPT_CUSTOMREQUEST => "DELETE",
CURLOPT_POSTFIELDS => json_encode([
'card_id' => '0e94dc61-5a2f-4b1e-9c3d-7f8a1b2c3d4e'
]),
CURLOPT_HTTPHEADER => [
"Authorization: Bearer <token>",
"Content-Type: application/json"
],
]);
$response = curl_exec($curl);
$err = curl_error($curl);
curl_close($curl);
if ($err) {
echo "cURL Error #:" . $err;
} else {
echo $response;
}package main
import (
"fmt"
"strings"
"net/http"
"io"
)
func main() {
url := "https://catchbackcards.com/api/partner/v1/listings"
payload := strings.NewReader("{\n \"card_id\": \"0e94dc61-5a2f-4b1e-9c3d-7f8a1b2c3d4e\"\n}")
req, _ := http.NewRequest("DELETE", url, payload)
req.Header.Add("Authorization", "Bearer <token>")
req.Header.Add("Content-Type", "application/json")
res, _ := http.DefaultClient.Do(req)
defer res.Body.Close()
body, _ := io.ReadAll(res.Body)
fmt.Println(string(body))
}HttpResponse<String> response = Unirest.delete("https://catchbackcards.com/api/partner/v1/listings")
.header("Authorization", "Bearer <token>")
.header("Content-Type", "application/json")
.body("{\n \"card_id\": \"0e94dc61-5a2f-4b1e-9c3d-7f8a1b2c3d4e\"\n}")
.asString();require 'uri'
require 'net/http'
url = URI("https://catchbackcards.com/api/partner/v1/listings")
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
request = Net::HTTP::Delete.new(url)
request["Authorization"] = 'Bearer <token>'
request["Content-Type"] = 'application/json'
request.body = "{\n \"card_id\": \"0e94dc61-5a2f-4b1e-9c3d-7f8a1b2c3d4e\"\n}"
response = http.request(request)
puts response.read_body{
"card_id": "0e94dc61-…",
"delisted": true
}{
"error": "<string>",
"code": "<string>"
}{
"error": "Missing or malformed API key"
}{
"error": "<string>",
"code": "<string>"
}{
"error": "<string>",
"code": "<string>"
}{
"error": "<string>",
"code": "<string>"
}{
"error": "<string>",
"code": "<string>"
}Authorizations
Your API key, sent as a bearer token. Keep it on your server. See Authentication. A request from a location we refuse gets a 403 with Access denied, whether or not it has a valid key: where you can call from.
Body
application/json
The listed card's card_id.