Retrieve a card request - Slash

GET

/

v2

/

card-requests

/

{cardRequestId}

Retrieve a card request

curl --request GET \
  --url https://api.slash.com/v2/card-requests/{cardRequestId} \
  --header 'X-API-Key: <api-key>' \
  --header 'x-legal-entity: <x-legal-entity>'

const options = {
  method: 'GET',
  headers: {'x-legal-entity': '<x-legal-entity>', 'X-API-Key': '<api-key>'}
};

fetch('https://api.slash.com/v2/card-requests/{cardRequestId}', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

import requests

url = "https://api.slash.com/v2/card-requests/{cardRequestId}"

headers = {
    "x-legal-entity": "<x-legal-entity>",
    "X-API-Key": "<api-key>"
}

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

print(response.text)

package main

import (
	"fmt"
	"net/http"
	"io"
)

func main() {

	url := "https://api.slash.com/v2/card-requests/{cardRequestId}"

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

	req.Header.Add("x-legal-entity", "<x-legal-entity>")
	req.Header.Add("X-API-Key", "<api-key>")

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

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

	fmt.Println(string(body))

}

{
  "id": "card_request_2rj4l7hmrrrcv",
  "status": "pending",
  "type": "virtual",
  "name": "Ads – Meta",
  "accountId": "sa_group_2rj4l7hmrrrcv",
  "requesterUserId": "u_2rj4l7hmrrrcv",
  "createdAt": "2023-11-07T05:31:56Z",
  "virtualAccountId": "subaccount_2rj4l7hmrrrcv",
  "cardGroupId": "card_group_2rj4l7hmrrrcv",
  "requestedLimit": {
    "amount": {
      "amount": 1250,
      "currency": "USD"
    },
    "period": "daily"
  },
  "memo": "<string>",
  "cardId": "c_2rj4l7hmrrrcv",
  "resolvedAt": "2023-11-07T05:31:56Z"
}

Authorizations

X-API-Key

string

header

required

User API key authentication. Create a key under Settings → API keys in the Slash dashboard (https://app.slash.com/global-settings/api-keys) and send the x-legal-entity header naming the legal entity to act on with every request. Keys scoped to a legal entity are rejected with 403 user_api_key_required.

Headers

x-legal-entity

string

required

The legal entity to act on. Required on every request; a user API key can act on any legal entity its user has access to.

Pattern: ^le_[a-zA-Z0-9]+$

Path Parameters

cardRequestId

string

required

Card request id with the card_request_ prefix.

Response

The card request.

A request for a card that an approver decides on in Slash.

id

string

required

Card request id with the card_request_ prefix.

Example:

"card_request_2rj4l7hmrrrcv"

status

enum<string>

required

approved requests issue their card shortly after; cardId is set once it exists.

Available options:

pending,

approved,

rejected,

canceled,

expired

type

enum<string>

required

Available options:

virtual,

physical

name

string

required

Example:

"Ads – Meta"

accountId

string

required

Example:

"sa_group_2rj4l7hmrrrcv"

requesterUserId

string

required

Example:

"u_2rj4l7hmrrrcv"

createdAt

string<date-time>

required

virtualAccountId

string

Example:

"subaccount_2rj4l7hmrrrcv"

cardGroupId

string

Example:

"card_group_2rj4l7hmrrrcv"

requestedLimit

CardRequestLimit · object

Hide child attributes

requestedLimit.amount

UsdMoney · object

required

A positive USD amount expressed in cents.

Hide child attributes

requestedLimit.amount.amount

integer

required

Amount in cents. For example, 1250 represents USD 12.50.

Required range: x >= 1

Example:

1250

requestedLimit.amount.currency

enum<string>

required

Available options:

USD

requestedLimit.period

enum<string>

required

Available options:

daily,

weekly,

monthly,

yearly,

lifetime

memo

string

cardId

string

The card issued for the request.

Example:

"c_2rj4l7hmrrrcv"

resolvedAt

string<date-time>

⌘I

Retrieve a card request

curl --request GET \
  --url https://api.slash.com/v2/card-requests/{cardRequestId} \
  --header 'X-API-Key: <api-key>' \
  --header 'x-legal-entity: <x-legal-entity>'

const options = {
  method: 'GET',
  headers: {'x-legal-entity': '<x-legal-entity>', 'X-API-Key': '<api-key>'}
};

fetch('https://api.slash.com/v2/card-requests/{cardRequestId}', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

import requests

url = "https://api.slash.com/v2/card-requests/{cardRequestId}"

headers = {
    "x-legal-entity": "<x-legal-entity>",
    "X-API-Key": "<api-key>"
}

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

print(response.text)

package main

import (
	"fmt"
	"net/http"
	"io"
)

func main() {

	url := "https://api.slash.com/v2/card-requests/{cardRequestId}"

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

	req.Header.Add("x-legal-entity", "<x-legal-entity>")
	req.Header.Add("X-API-Key", "<api-key>")

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

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

	fmt.Println(string(body))

}

{
  "id": "card_request_2rj4l7hmrrrcv",
  "status": "pending",
  "type": "virtual",
  "name": "Ads – Meta",
  "accountId": "sa_group_2rj4l7hmrrrcv",
  "requesterUserId": "u_2rj4l7hmrrrcv",
  "createdAt": "2023-11-07T05:31:56Z",
  "virtualAccountId": "subaccount_2rj4l7hmrrrcv",
  "cardGroupId": "card_group_2rj4l7hmrrrcv",
  "requestedLimit": {
    "amount": {
      "amount": 1250,
      "currency": "USD"
    },
    "period": "daily"
  },
  "memo": "<string>",
  "cardId": "c_2rj4l7hmrrrcv",
  "resolvedAt": "2023-11-07T05:31:56Z"
}