Need help with your APIs? I offer API discovery, governance & evangelism services. Explore services →
API Evangelist API Evangelist
Discovery
Learnings
Guidance
Toolbox
Alignment
API Evangelist LLC

magento Customers API

Customer account management including registration, profile updates, address management, authentication, and customer group assignment.

magento Customers API is one of 16 APIs that magento publishes on the APIs.io network, described by a machine-readable OpenAPI specification.

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

This API exposes 5 operations across 3 paths, and defines 6 schemas. It is described by OpenAPI 3.1.0, at version 2.4.

Requests are made against a single base URL, https://{store_domain}/rest/{store_code}.

5 operations 3 paths 6 schemas 1 DELETE2 GET1 POST1 PUT

Metadata

The identity and technical contract details declared by the specification.

Specification
OpenAPI 3.1.0
API Version
2.4
Base URL
https://your-store.example.com/rest
Authentication
HTTP Bearer
Terms of Service
Resource Areas
1

Authentication & Security 1

magento Customers API declares 1 security scheme for authenticating requests. It accepts HTTP bearer tokens (bearerAuth). By default, every request must be authenticated.

  • bearerAuth — Bearer token obtained from the /V1/integration/admin/token or /V1/integration/customer/token endpoint. Include in the Authorization header as "Bearer {token}".

Paths & Operations 5

Across 3 paths, the API surfaces 5 operations — 1 DELETE, 2 GET, 1 POST, 1 PUT. Each is listed below with its method, path, parameters, and response codes.

Customers 5

Customer account management including registration, profile updates, address management, authentication, and customer group assignment.

POST
/V1/customers
Create a customer
createCustomer body → 200400401
GET
/V1/customers/search
Search customers
searchCustomers 4 params → 200400401
GET
/V1/customers/{customerId}
Get customer by ID
getCustomer 1 param → 200401404
PUT
/V1/customers/{customerId}
Update a customer
updateCustomer 1 param body → 200400401404
DELETE
/V1/customers/{customerId}
Delete a customer
deleteCustomer 1 param → 200401404

Schemas 6

The contract defines 6 schemas that model the data the API accepts and returns. The most detailed are Customer (11 properties), Address (10 properties), CustomerSearchResults (3 properties), Error (2 properties). Each schema is shown below with its type and property counts.

CustomerSearchResults
object
Paginated search results containing a list of customer accounts.
3 properties
CustomerRequest
object
Request body for creating or updating a customer account.
2 properties 1 required
CustomAttribute
object
A key-value pair representing a custom EAV attribute on a catalog entity.
2 properties 2 required
Address
object
A postal address used for billing or shipping.
10 properties
Customer
object
A registered customer account in Adobe Commerce.
11 properties
Error
object
Standard error response returned for 4xx and 5xx responses.
2 properties

Specification

The full machine-readable OpenAPI contract behind this narrative.

Source

magento-customers-api-openapi.yml Raw ↑

Other APIs magento publishes across the network.

Magento GraphQL API
Magento SOAP API
Adobe Commerce Webhooks
Adobe Commerce Admin UI SDK
Adobe Commerce Eventing
magento Authentication API
magento Carts API
magento Categories API
magento Inventory API
magento Invoices API
magento Orders API
magento Products API