How AI is applied across API Evangelist and APIs.io. Read my AI disclosure →
API Evangelist API Evangelist
Discovery
Learnings
Guidance
Toolbox
Alignment
API Evangelist LLC

Marqeta Users API

// Conditional snippet for beta or internal contentinclude::../../maturity-admonition-banner.adoc[]// This source file is used by InfoDev to generate API reference documentation.// File location in GitHub is:// https://github.marqeta.com/openapi/coreapi/blob/main/openapi/users/openapi.yamlThe `users` resource represents a person who accesses Marqeta-administered funds via a Marqeta card (whether physical or virtual).This endpoint enables you to create and manage users on the Marqeta platform.This resource stores user attributes such as name, address, and date of birth, as well as financial information such as balances.By default, every user automatically has a general purpose account (GPA) that is used for the funding of transfers and is therefore an `account holder`.Note that account balances reside at the account holder level — there are no separate `account` or `balance` objects.You can use the `/users` endpoint to create parent-child relationships between two users (where one user is the parent and the other is the child) or between a business and a user (where the business is the parent and the user is the child).This relationship provides reporting to the parent about how cards of children are used and enables the parent to monitor and even restrict card usage.[NOTE]A user can simultaneously be a child of a business and a parent of other users if the user is not configured to use a parent's account balances and the user's child is configured to use a parent's account balances.For more information on account holders, see >.

Marqeta Users API is one of 81 APIs that Marqeta publishes on the APIs.io network, described by a machine-readable OpenAPI specification.

Tagged areas include User. The published artifact set on APIs.io includes an OpenAPI specification and API documentation.

This API exposes 23 operations across 20 paths, and defines 27 schemas. It is described by OpenAPI 3.0.3, at version 3.0.39.

Requests are made against a single base URL, /v3.

23 operations 20 paths 27 schemas 9 GET12 POST2 PUT

Metadata

The identity and technical contract details declared by the specification.

Specification
OpenAPI 3.0.3
API Version
3.0.39
Base URL
https://sandbox-api.marqeta.com/v3
Authentication
HTTP Basic
Contact
Terms of Service
Resource Areas
1

Authentication & Security 1

Marqeta Users API declares 1 security scheme for authenticating requests. It accepts HTTP basic authentication (mqAppAndAccessToken). By default, every request must be authenticated.

Paths & Operations 23

Across 20 paths, the API surfaces 23 operations — 9 GET, 12 POST, 2 PUT. Each is listed below with its method, path, parameters, and response codes.

Users 23

// Conditional snippet for beta or internal content include::../../maturity-admonition-banner.adoc[] // This source file is used by InfoDev to generate API reference documentation…

GET
/users
List users
getUsers 5 params → 200400500
POST
/users
Create user
postUsers body → 201400409412500
POST
/users/auth/changepassword
Update user password
postUsersAuthChangepassword body → 204400401500
POST
/users/auth/clientaccesstoken
Create client access token
postUsersAuthClientaccesstoken body → 201400401500
GET
/users/auth/clientaccesstoken/{token}
Retrieve client access token
getUsersAuthClientaccesstokenToken 2 params → 200400401403500
POST
/users/auth/login
Log in user
postUsersAuthLogin body → 204400401500
POST
/users/auth/logout
Log out user
postUsersAuthLogout → 204400401500
POST
/users/auth/onetime
Create single-use token
postUsersAuthOnetime body → 201400401500
POST
/users/auth/resetpassword
Request user password reset token
postUsersAuthResetpassword body → 204400401500
POST
/users/auth/resetpassword/{token}
Reset user password
postUsersAuthResetpasswordToken 1 param body → 204400401500
POST
/users/auth/verifyemail
Request email verification token
postUsersAuthVerifyemail → 204400401500
POST
/users/auth/verifyemail/{token}
Verify email address
postUsersAuthVerifyemailToken 1 param → 204400401500
POST
/users/lookup
Search users
postUsersLookup 5 params body → 200400500
GET
/users/{parent_token}/children
List user child accounts
getUsersParenttokenChildren 5 params → 200400500
GET
/users/{token}
Retrieve user
getUsersToken 2 params → 200400404500
PUT
/users/{token}
Update user
putUsersToken 1 param body → 200400500
GET
/users/{token}/ssn
Retrieve user identification number
getUsersTokenSsn 2 params → 200400500
GET
/users/phonenumber/{phone_number}
Lists all users who match a phone number
getUsersPhonenumberPhonenumber 5 params → 200400500
GET
/users/{token}/notes
Lists cardholder notes
getUsersTokenNotes 9 params → 200400401403404500
POST
/users/{token}/notes
Creates a note for the cardholder
postUsersTokenNotes 1 param body → 201400401403500
PUT
/users/{token}/notes/{notes_token}
Updates a specific note for a cardholder
putUsersTokenNotesNotestoken 2 params body → 201400401403500
GET
/views/users/{time_agg}
Retrieve user activity data
getUsers 8 params → 200400401
GET
/views/users/detail
Retrieve detailed user information
getUsersDetail 5 params → 200400401

Schemas 27

The contract defines 27 schemas that model the data the API accepts and returns. The most detailed are user_card_holder_response (40 properties), card_holder_model (34 properties), UserCardHolderUpdateModel (33 properties), access_token_response (8 properties). Each schema is shown below with its type and property counts.

IdentificationResponseModel
object
Contains identifications associated with the cardholder.
4 properties
CardHolderNoteListResponse
object
5 properties
cardholder_note_response_model
object
7 properties 2 required
user_card_holder_response
object
Contains information about a cardholder.
40 properties 2 required
reset_user_password_email_model
object
1 property 1 required
ssn_response_model
object
Contains tax identification information.
4 properties
cardholder_note_update_request_model
object
1 property 1 required
client_access_token_response
object
5 properties
UsersDetailResponse
object
Detailed user records response.
2 properties
ErrorResponse
object
Standard error response returned by the Marqeta DiVA API.
2 properties
UserCardHolderListResponse
object
5 properties
user_card_holder_search_model
object
6 properties
cardholder_note_request_model
object
5 properties 2 required
card_holder_model
object
Contains information about a cardholder.
34 properties
login_request_model
object
3 properties
access_token_response
object
Contains a cardholder's login access information.
8 properties 1 required
login_response_model
object
2 properties
Application
object
Contains client application information.
7 properties
password_update_model
object
2 properties 2 required
reset_user_password_model
object
2 properties 2 required
one_time_request_model
object
3 properties
UsersResponse
object
User activity data response.
2 properties
client_access_token_request
object
2 properties 1 required
Authentication
object
Contains the cardholder's email address and password information.
4 properties
IdentificationRequestModel
object
Contains identifications associated with the cardholder.
4 properties 1 required
DivaResponseMeta
object
Metadata included in DiVA API paginated responses.
4 properties
UserCardHolderUpdateModel
object
33 properties

Specification

The full machine-readable OpenAPI contract behind this narrative.

Source

marqeta-users-api-openapi.yml Raw ↑

Other APIs Marqeta publishes across the network.

Marqeta Webhooks
Marqeta Risk Controller / Real-Time Decisioning
Marqeta accepted countries API
Marqeta Account API
Marqeta Account Bundle Transitions API
Marqeta Account Cards API
Marqeta Account Documents API
Marqeta account holder groups API
Marqeta Account Refunds API
Marqeta Account Rewards API
Marqeta Account Signup Bonus API
Marqeta Account Transitions API
Where this information came from

This is an independent, third-party profile of Marqeta Users API, published by API Evangelist. We do not operate, host, resell, or support these APIs, and we are not affiliated with or endorsed by the company unless stated above. Everything here is built from publicly available information — the company's own site, developer portal, documentation, public repositories, and the specifications it publishes for public use. Nothing is obtained by breaching a system, defeating an access control, or using credentials.

The Kin Score and Agent Readiness rating are independently calculated assessments of a company's public API artifacts, scored against a published rubric. They are not certifications, endorsements, security assessments, or audits.

Corrections, re-scores, and removal are free — no partnership or purchase required, and you do not need to justify the request. A removed company is recorded as unrated, never scored zero for having asked. Acknowledgement within one business day; removal within two.

info@apievangelist.com · Read the full data-sourcing policy →
On a security or compliance team? Put security in the subject line and you will get a person, not a form — we will tell you exactly which public URLs this profile was built from.