Understanding API Objects

The Marqeta API uses objects to represent concepts for issuing payments cards and customizing card behavior. First-class objects are generally the most important objects on the Marqeta platform and occupy the first node in an endpoint URL. Some examples of first-class objects include:

  • card – represents a payment card (physical or virtual) for conducting transactions.
  • user – represents a person who uses a payment card.
  • gpaorder – used to load funds into an account.
  • fundingsource – represents the source from which a gpaorder draws funds.

To see how the fundamental API objects interrelate, refer to the Summary of Resources.


Accessing the Sandbox API

Marqeta provides a shared sandbox environment that allows you to safely explore the capabilities of the API. The base URL for the shared sandbox is:

https://shared-sandbox-api.marqeta.com/v3

Note that this is a shared environment and you should not populate it with sensitive data. For detailed information on accessing and using the shared sandbox, refer to the Quick Start guide.


Accessing the Production API

Each Marqeta customer who enters into an agreement to receive Marqeta’s services will access the API and operate within an individually tailored production environment called a program.

To access the API in production, you use the unique base URL for your program. Be sure to update any tests or code samples with the correct base URL. For example:

{program_base_URL}/v3/users


Listing Endpoints

You can return a listing of the available API endpoints by issuing a GET request to the /swagger.json endpoint, for example:

https://shared-sandbox-api.marqeta.com/v3/swagger.json

The response lists the endpoints you are authorized to access based on the credentials you provide in your request.