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

MVMNT Customers API

Customer management operations

MVMNT Customers API is one of 27 APIs that MVMNT 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, an API reference, API documentation, and a getting-started guide.

This API exposes 8 operations across 6 paths, and defines 66 schemas. It is described by OpenAPI 3.1.0, at version 1.0.0.

Requests are made against a single base URL, https://api.mvmnt.io/v1.

8 operations 6 paths 66 schemas 1 DELETE3 GET1 PATCH3 POST

Metadata

The identity and technical contract details declared by the specification.

Specification
OpenAPI 3.1.0
API Version
1.0.0
Base URL
https://api.mvmnt.io/v1
Authentication
HTTP Bearer
Resource Areas
1

Authentication & Security 1

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

  • BearerAuth — OAuth 2.0 access token obtained via client credentials flow

Paths & Operations 8

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

Customers 8

Customer management operations

POST
/customers/filter
Filter customers
filterCustomers body → 200400401422429
POST
/customers
Create customer
createCustomer body → 201400401422429
GET
/customers/{id}
Get customer
getCustomer 2 params → 200401404429
PATCH
/customers/{id}
Update customer
updateCustomer 2 params body → 200400401404422429
DELETE
/customers/{id}
Delete customer
deleteCustomer 2 params → 204401404429
POST
/customers/search
Search customers
searchCustomers body → 200400401422429
GET
/customers/{id}/payments
Get customer payments
getCustomerPayments 4 params → 200401404
GET
/customers/{id}/outstanding-invoices
Get outstanding invoices
getCustomerOutstandingInvoices 2 params → 200401404

Schemas 66

The contract defines 66 schemas that model the data the API accepts and returns. The most detailed are Customer (50 properties), CustomerSearchRow (45 properties), CustomerSearchCriteria (44 properties), CustomerPatch (39 properties). Each schema is shown below with its type and property counts.

CustomerTransportationMode
string
Transportation mode type
AddressPatch
object
Partial address update. All fields are optional. - Omitted fields: Not modified (current value preserved) - Provided fields: Updated to the new value - Null va…
12 properties
CustomerAnnualRevenueFilter
object
Filter options for CustomerAnnualRevenue enum
5 properties
ContactInfo
object
Contact information details (nested, without id). This is an embedded object representing a Contact record. The id is managed internally and not exposed in the…
4 properties 1 required
CustomerSearchResponse
object
Response for customer search requests. Note: Only active (non-deleted) customers are included in results.
3 properties 3 required
CustomerServiceTier
string
Service tier level for the customer
CustomerAnnualSpend
string
Annual freight spend estimate range
ShowNotes
string
Controls whether external notes are shown on all documents or split from carrier-facing notes. - ALL: Use external notes on customer-facing and carrier-facing…
DatetimeSearchCriteria
object
Search criteria for datetime fields. Supports both absolute datetime values and relative time expressions.
10 properties 1 required
TextSearchCriteria
object
Search criteria for text fields (supports wildcards and partial matching)
2 properties 1 required
ValidationError
object
3 properties 3 required
Address
object
Physical address/location details (nested, without id). This is an embedded object representing a Location record. The id is managed internally and not exposed…
12 properties 8 required
Error
object
2 properties 2 required
ClientKeyFilter
object
Filter options for client key fields (limited operations - exact match only)
3 properties
KeywordSearchCriteria
object
Search criteria for keyword fields (exact match, no partial matching)
2 properties 1 required
PaymentCreditApplication
object
4 properties
SearchPaginationInput
object
Pagination options for search requests
2 properties
CustomerSearchRow
object
Flattened customer data from search index. Note: This represents only active customers. Soft-deleted records are never returned.
45 properties 7 required
CustomerCurrency
string
Preferred currency for transactions
IntSearchCriteria
object
Search criteria for integer fields
4 properties 1 required
PaginationInfo
object
4 properties 2 required
OutstandingInvoicesResponse
object
2 properties 2 required
CustomerAnnualRevenue
string
Annual revenue range
FloatSearchCriteria
object
Search criteria for float/decimal fields
4 properties 1 required
CustomerPatch
object
Partial customer update. All fields are optional. - Omitted fields: Not modified (current value preserved) - Provided fields: Updated to the new value - Null v…
39 properties
Customer
object
50 properties 6 required
PaymentTermReference
object
Enhanced reference to a payment term resource (returned in responses). Includes full payment term details in addition to id/key.
11 properties 4 required
CustomerTransportationModeFilter
object
Filter options for CustomerTransportationMode enum
5 properties
DateSearchCriteria
object
Search criteria for date fields (no time component). Supports both absolute date values and relative time expressions.
10 properties 1 required
CustomerContactType
string
Type of customer contact role
CustomerSpendType
string
Customer spend type: - CONTRACT: Customer operates under contract pricing - SPOT: Customer operates on spot market pricing
UUIDSearchCriteria
object
Search criteria for UUID fields
2 properties 1 required
AddressInput
object
Address data for creating a new location
12 properties 4 required
RelativeTimeUnit
string
Time unit for relative time calculations: - YEAR: Years - MONTH: Months - WEEK: Weeks - DAY: Days - HOUR: Hours - MINUTE: Minutes - SECOND: Seconds
SearchPaginationInfo
object
Pagination information for search results
3 properties 3 required
CustomerStatus
string
Customer account status (includes lead stages): - NEW: New lead, not yet contacted - CONTACTED: Initial contact made with lead - QUALIFIED: Lead has been quali…
CustomerFilter
object
Filter criteria for customers with AND/OR logic support
28 properties
CustomerReference
object
Enhanced reference to a customer resource (returned in responses). Includes full customer details in addition to id/key. Note: Does NOT include nested referenc…
10 properties 6 required
PaymentApplication
object
6 properties 3 required
CustomerStatusFilter
object
Filter options for CustomerStatus enum
5 properties
CustomerCurrencyFilter
object
Filter options for CustomerCurrency enum
5 properties
CustomerContactReference
object
Customer contact reference for embedding in Customer responses. Identical to CustomerContact but excludes the customer and customerId fields to avoid circular…
13 properties 5 required
DatetimeFilter
object
Filter options for datetime fields
7 properties
CustomerNumberOfEmployees
string
Number of employees in the company
IDFilter
object
Filter options for ID fields (limited operations - exact match only)
2 properties
UserReference
object
Enhanced reference to a user resource (returned in responses). Includes full user details in addition to id/key. Note: Does NOT include nested references (team…
11 properties 5 required
ResourceReference
object
Reference to another resource (returned in responses)
2 properties 1 required
StringFilter
object
Filter options for string fields
11 properties
CustomerInput
object
39 properties 2 required
CustomerFilterRequest
object
Request body for filtering customers
3 properties
payments_PaymentMethodType
string
Payment method type. - ACHWIRE: ACH or wire transfer - ZELLE: Zelle payment - VENMO: Venmo payment - CHECK: Paper check - EFTDIRECTDEPOSIT: EFT direct deposit…
SearchSortOption
object
Sort option for search results
2 properties 2 required
CustomerSearchRequest
object
Request body for searching customers
5 properties
SavedSearchLookup
object
Reference to a saved search by ID or client key. Provide either id or key (not both).
2 properties
CustomerNumberOfEmployeesFilter
object
Filter options for CustomerNumberOfEmployees enum
5 properties
CustomerServiceTierFilter
object
Filter options for CustomerServiceTier enum
5 properties
CustomerAnnualSpendFilter
object
Filter options for CustomerAnnualSpend enum
5 properties
ResourceReferenceInput
object
Reference to another resource by either ID or client key (used in create/update requests)
2 properties
CustomerIndustry
string
Industry classification for the customer
CustomerDeactivationReasonFilter
object
Filter options for CustomerDeactivationReason enum
5 properties
CustomerDeactivationReason
string
Reason for customer deactivation: - NOTPAYINGINVOICE: Customer is not paying invoices - ACQUIRED: Customer was acquired by another company - DUPLICATE: Duplica…
CustomerIndustryFilter
object
Filter options for CustomerIndustry enum
5 properties
CustomerSearchCriteria
object
Search criteria for filtering customers. Note: Only active (non-deleted) customers are searchable. Soft-deleted records are automatically excluded.
44 properties
Payment
object
18 properties 4 required
CustomerContactNotificationType
string
Types of shipment notifications the contact should receive
CustomerSpendTypeFilter
object
Filter options for CustomerSpendType enum
5 properties

Specification

The full machine-readable OpenAPI contract behind this narrative.

Source

mvmnt-customers-api-openapi.yml Raw ↑

Other APIs MVMNT publishes across the network.

MVMNT Bill Payments API
MVMNT Bills API
MVMNT Carrier Contacts API
MVMNT Carrier Factors API
MVMNT Carrier Payment Methods API
MVMNT Carriers API
MVMNT Companies API
MVMNT Credit Memos API
MVMNT Customer Contacts API
MVMNT Documents API
MVMNT Invoices API
MVMNT Loads API
Where this information came from

This is an independent, third-party profile of MVMNT Customers 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.