Fetch a Card

Fetch a Card

curl --request GET \
  --url https://api.treasuryprime.com/card/{id} \
  --header 'Authorization: Basic <encoded-value>'

const options = {method: 'GET', headers: {Authorization: 'Basic <encoded-value>'}};

fetch('https://api.treasuryprime.com/card/{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.treasuryprime.com/card/{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: Basic <encoded-value>"
  ],
]);

$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.treasuryprime.com/card/{id}"

	req, _ := http.NewRequest("GET", url, nil)

	req.Header.Add("Authorization", "Basic <encoded-value>")

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

require 'uri'
require 'net/http'

url = URI("https://api.treasuryprime.com/card/{id}")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Get.new(url)
request["Authorization"] = 'Basic <encoded-value>'

response = http.request(request)
puts response.read_body

{
  "account_id": "acct_291u96075mva",
  "card_controls": null,
  "card_product_id": "cdpt_w10r2sebv0nl",
  "created_at": "2021-02-19T20:42:40Z",
  "cvv": null,
  "expiration": "0225",
  "external_id": "tprime_card_zuhqnmz7e085",
  "fulfillment": {
    "shipping_method": "USPS Mail (5-7 business days)",
    "status": "issued",
    "tracking_number": null
  },
  "id": "card_zuhqnmz7e085",
  "last4": "3385",
  "pan": null,
  "person_id": "psn_5vyzn6sveupa",
  "pin_is_set": false,
  "status": "unactivated",
  "updated_at": "2021-02-19T20:42:41Z",
  "userdata": null
}

GET

card

{id}

Fetch a Card

curl --request GET \
  --url https://api.treasuryprime.com/card/{id} \
  --header 'Authorization: Basic <encoded-value>'

const options = {method: 'GET', headers: {Authorization: 'Basic <encoded-value>'}};

fetch('https://api.treasuryprime.com/card/{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.treasuryprime.com/card/{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: Basic <encoded-value>"
  ],
]);

$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.treasuryprime.com/card/{id}"

	req, _ := http.NewRequest("GET", url, nil)

	req.Header.Add("Authorization", "Basic <encoded-value>")

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

require 'uri'
require 'net/http'

url = URI("https://api.treasuryprime.com/card/{id}")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Get.new(url)
request["Authorization"] = 'Basic <encoded-value>'

response = http.request(request)
puts response.read_body

{
  "account_id": "acct_291u96075mva",
  "card_controls": null,
  "card_product_id": "cdpt_w10r2sebv0nl",
  "created_at": "2021-02-19T20:42:40Z",
  "cvv": null,
  "expiration": "0225",
  "external_id": "tprime_card_zuhqnmz7e085",
  "fulfillment": {
    "shipping_method": "USPS Mail (5-7 business days)",
    "status": "issued",
    "tracking_number": null
  },
  "id": "card_zuhqnmz7e085",
  "last4": "3385",
  "pan": null,
  "person_id": "psn_5vyzn6sveupa",
  "pin_is_set": false,
  "status": "unactivated",
  "updated_at": "2021-02-19T20:42:41Z",
  "userdata": null
}

The external_id field in the response can be passed as card-token when using Marqeta UX Toolkit components.

Authorizations

Authorization

string

header

required

Basic authentication header of the form Basic <encoded-value>, where <encoded-value> is the base64-encoded string username:password.

Path Parameters

string

required

Unique identifier for object

Response

200 - application/json

The card

account_id

string

The ID of the account that the card should be issued against. Filterable.

card_controls

object

An object that defines rules for how this card can be used

Show child attributes

card_product_id

string

The ID of the card product that this card should be issued from. Filterable.

creation_options

object

An object that defines additional fields for card customization on creation

Show child attributes

cvv

string

The 3-digit card verification code. Note this field will return null unless the show_cvv query parameter is set

expiration

string

The card expiration year and month, in MMYY format

fulfillment

object

Information about the card's fulfillment process

Show child attributes

string

Unique identifier for object

last4

string

Last 4 digits of the card number. Filterable.

new_pan_from_card_id

string

The ID of a card to reissue. If this field is entered a new card will be created without pin, a new PAN, CVV and expiration

pan

string

The primary 16-digit card number. Note this field will return null unless the show_pan parameter is set

person_id

string

The ID of the person representing the cardholder that this card will be issued to. Filterable.

pin_is_set

boolean

Reflects whether the user has set a PIN on the card; initially false

reissue_pan_from_card_id

string

The ID of a card to reissue. If this field is entered a new card will be created with the same PAN and pin, but new CVV and expiration.

show_cvv

enum<string>

When true, the cvv field will be returned with non-null data. False by default. Requires PCI compliance.

Available options:

true,

false

show_pan

enum<string>

When true, the pan field will be returned with non-null data. False by default. Requires PCI compliance.

Available options:

true,

false

status

string

One of: unactivated, active, suspended, terminated. Filterable.

userdata

object

Optional arbitrary user data

Introduction

Account

Account Opening

Cards

Payments

Testing

Utilities

Authorizations

Path Parameters

Response