Create Bulk Card Order

Use the Create Bulk Card Order endpoint to initiate a request for a batch of instant-issue cards. Consult the Instant-Issue Cards guide for instructions on using this endpoint.

Status codes

See Global Response Statuses for status codes that are common across endpoints.

The table below lists status codes that apply to this specific endpoint.

Status codeDescription
427-01Invalid or unrecognized location ID
427-02Invalid or unauthorized product ID
Form Data
string
required

Web service username, as provided by SoFi Tech Solutions.
Pattern: Max 50 characters
Example: "AbC123-9999"

string
required

Web service password, as provided by SoFi Tech Solutions.
Pattern: Max 15 characters
Example: "4sb62fh6w4h7w34g"

string
required
1 to 60

Supply a globally unique ID to identify this endpoint request ("transaction"). Might be used for idempotency.. A UUID is preferred.
Pattern: Maximum 60 characters
Example: "9845dk-39fdk3fj3-4483483478"

int32
required

A unique product identifier from SoFi Tech Solutions.
Pattern: Integer
Example: 501

int32
required

Number of cards to be created.
Pattern: Positive integer
Example: 1000

string | null
^[a-zA-Z0-9_\s]{1,20}$

Optional string to be printed on the first emboss line of the cards.
Pattern: Max 20 alphanumeric characters
Example: "Bob's cards"

string
required
1 to 40

In-care-of name for the address where the bulk card order is to be shipped.
Pattern: Max 40 alphanumeric characters
Example: "c"

string
required

Street address where the bulk order is to be shipped.
Pattern: Max 40 alphanumeric characters
Example: "33 Maple Street"

string
required

City where the bulk order is to be shipped.
Pattern: Max 20 alphanumeric characters
Example: "Salt Lake City"

string
required

State or province where the bulk order is to be shipped.
Pattern: 2-character state or province code
Example: "UT"

string
required
length between 5 and 10
^[a-zA-Z0-9\-\ ]*$

Postal code where the bulk order is to be shipped
Pattern: 12345, 12345-6789, or K1A-1A1
Example: "84121"

string
required
length between 1 and 15
^[a-zA-Z0-9]{1,15}$

Location identifier as returned by Create Location (location) or Get Locations (location_id or provider_specified_id).
Pattern: Integer if location or location_id; max 15 characters if provider_specified_id
Example: "a455-3483"

int32
enum
Defaults to 0

Type of ID in location:

  • 0 — SoFi Tech Solutions location ID
  • 1 — Partner location ID

Pattern: Integer
Example: 1

Allowed:
Headers
string
enum
Defaults to json

Use this header instead of the standard accept header to specify the response format.

Allowed:
string
enum
Defaults to application/json

Generated from available response content types

Allowed:
Response

Language
URL
LoadingLoading…
Response
Click Try It! to start a request and see the response here! Or choose an example:
application/json
application/xml

© SoFi Technology Solutions, LLC 2026    Privacy Disclosure

All documentation, including but not limited to text, graphics, images, and any other content, are the exclusive property of SoFi Technology Solutions, LLC and are protected by copyright laws. These materials may not be reproduced, distributed, transmitted, displayed, or otherwise used without the prior written permission of SoFi Technology Solutions, LLC. Any unauthorized use or reproduction of these materials are expressly prohibited.