Welcome to the givecard api

Getting Started

GiveCard APIs

auth
- Test Authget
cardLoadsTransfers
bankTransfers
orderCards
simulate
fundingAccount
reporting
merchantRulesDeprecated
superbusiness
- Create Programpost
- Get Programsget
webhooks
manageCard
spendRules

Welcome to the givecard api

Getting Started

GiveCard APIs

auth
- Test Authget
cardLoadsTransfers
bankTransfers
orderCards
simulate
fundingAccount
reporting
merchantRulesDeprecated
superbusiness
- Create Programpost
- Get Programsget
webhooks
manageCard
spendRules

Issue Virtual Cards

post https://api.dev.givecard.dev/api/v1/cards/issueVirtual

Creates and delivers virtual cards to the given email addresses. This endpoint returns the count and external IDs of cards ordered, and the card order.
Optionally pass in an amount to load funds onto the card upon order.
Optionally pass in spend rule ID(s) to apply spend rule(s) to the cards upon order. To create a spend rule and limit where and how cardholders can use funds, refer to Create Spend Rule.

URL Expired

The URL for this request expired after 30 days.

Body Params

amount

string

emailAddresses

array of strings

required

The email address(es) that cards will be sent to. An email address can only have one card sent to it. Maximum of 300 cards per order.

emailAddresses*

merchantRuleId

string

Deprecated: please use spend rule ids param instead.

programId

string

Program ID is only required for superbusinesses.

spendRuleIds

array of uuids

Passing in a spend rule id(s) applies spend rule(s) to a card upon order. To create a spend rule and limit where cardholders can use funds, refer to Create Spend Rule.

spendRuleIds

Headers

Idempotency-Key

string

Responses

Response body

object

cardOrder

object

cardCount

int64

The count of cards that were requested for the order.

cardOrderCardType

string

physical virtual

cardsProcessed

int64

The count of cards that were sent to the manufacturer for shipping (physical cards) or that were virtually delivered (virtual cards). This number should match CardCount.

createdAt

date-time

The time that the card order was made in UTC.

deliveredAt

date-time

The time that the card order was delivered at in UTC.

uuid

The card order's primary identifier.

metadata

array of objects

metadata

object

key

string

value

string

orderStatus

string

created processing shipped cancelled delivered fulfilled failed

shipmentMethod

string

USPS_GROUND USPS_PRIORITY UPS_NEXT_DAY UPS_SECOND_DAY

shippedAt

date-time

The time that the card order was shipped at in UTC.

shippingAddress

object

trackingNumber

string

The tracking number is added to the card order upon shipment.

updatedAt

date-time

The time of the most recent update made to the card order in UTC.

cardsOrdered

int64

The count of cards successfully ordered.

externalIds

array of strings

The external IDs of the cards that were ordered.

externalIds

Response body

object

badRequest

object

Describes violations in a client request. This error type focuses on the
syntactic aspects of the request.

fieldViolations

array of objects

Describes all violations in a client request.

fieldViolations

object

description

string

A description of why the request element is bad.

field

string

A path leading to a field in the request body. The value will be a
sequence of dot-separated identifiers that identify a mesasge field.
E.g., "fieldViolations.field" would identify this field.

code

int64

errorInfo

object

Metadata

object

Has additional fields

Reason

string

The reason of the error. This is a constant value that identifies the
proximate cause of the error.
This should be at most 63 characters and match /[A-Z0-9_]+/.
UNKNOWN ReasonUnknown
OUTDATED_VERSION ReasonOutdatedVersion

UNKNOWN OUTDATED_VERSION

fieldErrors

object

Has additional fields

localizedMessage

object

Provides a localized error message that is safe to return to the user
which can be attached to an RPC error.

locale

string

The locale used following the specification defined at
http://www.rfc-editor.org/rfc/bcp/bcp47.txt.
Examples are: "en-US", "fr-CH", "es-MX"

message

string

The localized error message in the above locale.

msg

string

required

requestInfo

object

Contains metadata about the request that clients can attach when filing a bug
or providing other forms of feedback.

requestID

string

An opaque string that should only be interpreted by the service generating
it. For example, it can be used to identify requests in the service's logs.

servingData

string

Any data that was used to serve this request. For example, an encrypted
stack trace that can be sent back to the service provider for debugging.

Response body

object

badRequest

object

Describes violations in a client request. This error type focuses on the
syntactic aspects of the request.

fieldViolations

array of objects

Describes all violations in a client request.

fieldViolations

object

description

string

A description of why the request element is bad.

field

string

A path leading to a field in the request body. The value will be a
sequence of dot-separated identifiers that identify a mesasge field.
E.g., "fieldViolations.field" would identify this field.

code

int64

errorInfo

object

Metadata

object

Has additional fields

Reason

string

UNKNOWN OUTDATED_VERSION

fieldErrors

object

Has additional fields

localizedMessage

object

Provides a localized error message that is safe to return to the user
which can be attached to an RPC error.

locale

string

The locale used following the specification defined at
http://www.rfc-editor.org/rfc/bcp/bcp47.txt.
Examples are: "en-US", "fr-CH", "es-MX"

message

string

The localized error message in the above locale.

msg

string

required

requestInfo

object

Contains metadata about the request that clients can attach when filing a bug
or providing other forms of feedback.

requestID

string

An opaque string that should only be interpreted by the service generating
it. For example, it can be used to identify requests in the service's logs.

servingData

string

Any data that was used to serve this request. For example, an encrypted
stack trace that can be sent back to the service provider for debugging.

Response body

object

badRequest

object

Describes violations in a client request. This error type focuses on the
syntactic aspects of the request.

fieldViolations

array of objects

Describes all violations in a client request.

fieldViolations

object

description

string

A description of why the request element is bad.

field

string

A path leading to a field in the request body. The value will be a
sequence of dot-separated identifiers that identify a mesasge field.
E.g., "fieldViolations.field" would identify this field.

code

int64

errorInfo

object

Metadata

object

Has additional fields

Reason

string

UNKNOWN OUTDATED_VERSION

fieldErrors

object

Has additional fields

localizedMessage

object

Provides a localized error message that is safe to return to the user
which can be attached to an RPC error.

locale

string

The locale used following the specification defined at
http://www.rfc-editor.org/rfc/bcp/bcp47.txt.
Examples are: "en-US", "fr-CH", "es-MX"

message

string

The localized error message in the above locale.

msg

string

required

requestInfo

object

Contains metadata about the request that clients can attach when filing a bug
or providing other forms of feedback.

requestID

string

An opaque string that should only be interpreted by the service generating
it. For example, it can be used to identify requests in the service's logs.

servingData

string

Any data that was used to serve this request. For example, an encrypted
stack trace that can be sent back to the service provider for debugging.

Response body

object

badRequest

object

Describes violations in a client request. This error type focuses on the
syntactic aspects of the request.

fieldViolations

array of objects

Describes all violations in a client request.

fieldViolations

object

description

string

A description of why the request element is bad.

field

string

A path leading to a field in the request body. The value will be a
sequence of dot-separated identifiers that identify a mesasge field.
E.g., "fieldViolations.field" would identify this field.

code

int64

errorInfo

object

Metadata

object

Has additional fields

Reason

string

UNKNOWN OUTDATED_VERSION

fieldErrors

object

Has additional fields

localizedMessage

object

Provides a localized error message that is safe to return to the user
which can be attached to an RPC error.

locale

string

The locale used following the specification defined at
http://www.rfc-editor.org/rfc/bcp/bcp47.txt.
Examples are: "en-US", "fr-CH", "es-MX"

message

string

The localized error message in the above locale.

msg

string

required

requestInfo

object

Contains metadata about the request that clients can attach when filing a bug
or providing other forms of feedback.

requestID

string

An opaque string that should only be interpreted by the service generating
it. For example, it can be used to identify requests in the service's logs.

servingData

string

Any data that was used to serve this request. For example, an encrypted
stack trace that can be sent back to the service provider for debugging.

Updated about 2 months ago

Issue a Single Card Synchronously

Issue Virtual Card And Generate Link

Did this page help you?

Language

Credentials

Header


xxxxxxxxxx
1
curl --request POST \
2
     --url https://api.dev.givecard.dev/api/v1/cards/issueVirtual \
3
     --header 'accept: */*' \
4
     --header 'content-type: application/json'

Click Try It! to start a request and see the response here! Or choose an example:

*/*

Updated about 2 months ago

Issue a Single Card Synchronously

Issue Virtual Card And Generate Link

Did this page help you?

Welcome to the givecard api
Getting Started
FAQs
GiveCard Transfers: RTP, FedNow, ACH
Webhooks
Spend Rules
MerchantCategories
Greenlighting and Redlighting
Velocity Spend Rules
Merchant Spend Rules
SuperBusinesses and ProgramIds
Idempotency
Authentication
Quickstart

GiveCard APIs
auth
Test Authget
cardLoadsTransfers
Withdraw Funds From Cardpost
Load Cardspost
Card To Card Transferpost
Delete Cards From Autoloaddelete
Add Cards To Autoloadpost
Modify Autoload Profilepatch
Get Autoload Profileget
Get Business Autoload Profilesget
Create Autoload Profilepost
bankTransfers
Get Bank Transferget
Initiate Bank Transferpost
Get Bank Transfersget
Get Bank Transfers for Recipientget
Add Bank Account to Recipientpost
Get Bank Transfer Recipientget
Get Bank Transfer Recipientsget
Update Recipientpatch
Create Bank Transfer Recipientpost
Delete Bank Accountdelete
orderCards
Order And Ship Cardspost
Issue Virtual Card And Generate Linkpost
Issue Virtual Cardspost
Issue a Single Card Synchronouslypost
Get Individual Card Orderget
Get Business Card Ordersget
simulate
Simulate Transactionpost
Simulate Funding Account Depositpost
Simulate Card Order Shippedpost
fundingAccount
Get Funding Accountsget
Get Funding Account Depositsget
Transfer Between Funding Accountspost
Get Funding Account Balanceget
reporting
Get Cardsget
Get Business Transactionsget
Get Business Card Load Historyget
merchantRulesDeprecated
Add Merchant Rule To Cardpost
Remove Merchant Rule From Carddelete
Modify Merchant Rule (decommissioned)patch
Get Merchant Ruleget
Get Business Merchant Rulesget
Create Merchant Rule (decommissioned)post
superbusiness
Get Programsget
Create Programpost
webhooks
Get Webhook Endpoint Secretget
Create Webhook Endpointpost
Get Webhook Endpointsget
Get Webhook Portal Access Linkget
manageCard
Unlock Cardpost
Unfreeze Cardpost
Get Card Transactionsget
Delete Tag from Carddelete
Reissue Virtual Cardpost
Reissue And Ship Physical Cardpost
Reassociate Cardpost
Set Card Pinpost
Lock Cardpost
Get Card Load Historyget
Freeze Cardpost
Get Card Detailsget
Close Cardpost
Generate Card Client Tokenpost
Get Card Balanceget
Add Tag To Cardspost
spendRules
Remove Spend Rule From Card(s)delete
Add Spend Rule To Card(s)post
Update Spend Rulepatch
Delete Spend Ruledelete
Create Spend Rulepost
Get Spend Rulesget
Get Spend Rules On Cardget

Welcome to the givecard api
Getting Started
FAQs
GiveCard Transfers: RTP, FedNow, ACH
Webhooks
Spend Rules
MerchantCategories
Greenlighting and Redlighting
Velocity Spend Rules
Merchant Spend Rules
SuperBusinesses and ProgramIds
Idempotency
Authentication
Quickstart

GiveCard APIs
auth
Test Authget
cardLoadsTransfers
Withdraw Funds From Cardpost
Load Cardspost
Card To Card Transferpost
Delete Cards From Autoloaddelete
Add Cards To Autoloadpost
Modify Autoload Profilepatch
Get Autoload Profileget
Get Business Autoload Profilesget
Create Autoload Profilepost
bankTransfers
Get Bank Transferget
Initiate Bank Transferpost
Get Bank Transfersget
Get Bank Transfers for Recipientget
Add Bank Account to Recipientpost
Get Bank Transfer Recipientget
Get Bank Transfer Recipientsget
Update Recipientpatch
Create Bank Transfer Recipientpost
Delete Bank Accountdelete
orderCards
Order And Ship Cardspost
Issue Virtual Card And Generate Linkpost
Issue Virtual Cardspost
Issue a Single Card Synchronouslypost
Get Individual Card Orderget
Get Business Card Ordersget
simulate
Simulate Transactionpost
Simulate Funding Account Depositpost
Simulate Card Order Shippedpost
fundingAccount
Get Funding Accountsget
Get Funding Account Depositsget
Transfer Between Funding Accountspost
Get Funding Account Balanceget
reporting
Get Cardsget
Get Business Transactionsget
Get Business Card Load Historyget
merchantRulesDeprecated
Add Merchant Rule To Cardpost
Remove Merchant Rule From Carddelete
Modify Merchant Rule (decommissioned)patch
Get Merchant Ruleget
Get Business Merchant Rulesget
Create Merchant Rule (decommissioned)post
superbusiness
Get Programsget
Create Programpost
webhooks
Get Webhook Endpoint Secretget
Create Webhook Endpointpost
Get Webhook Endpointsget
Get Webhook Portal Access Linkget
manageCard
Unlock Cardpost
Unfreeze Cardpost
Get Card Transactionsget
Delete Tag from Carddelete
Reissue Virtual Cardpost
Reissue And Ship Physical Cardpost
Reassociate Cardpost
Set Card Pinpost
Lock Cardpost
Get Card Load Historyget
Freeze Cardpost
Get Card Detailsget
Close Cardpost
Generate Card Client Tokenpost
Get Card Balanceget
Add Tag To Cardspost
spendRules
Remove Spend Rule From Card(s)delete
Add Spend Rule To Card(s)post
Update Spend Rulepatch
Delete Spend Ruledelete
Create Spend Rulepost
Get Spend Rulesget
Get Spend Rules On Cardget

200

400

404

409

500