Bill Payments8

Bills11

Carrier Contacts5

Carrier Factors6

Carrier Payment Methods5

Carriers8

Companies5

Credit Memos8

Customer Contacts5

Customers8

Documents20

Invoices11

Loads13

Location Contacts5

Locations6

Payment Terms5

Payments6

Quotes6

Reference Data3

Saved Searches5

Search1

Services5

Shipments16

Stops5

Teams5

Users6

Vendor Contacts5

Vendor Payment Methods5

Vendors8

Webhooks

Event Notifications1

Vendors

Get a vendor by ID

Changed on Oct 7, 2026

Retrieve a single vendor by its unique identifier.

get/vendors/{id}

Request

Base URL: https://api.mvmnt.io/v1
URL: https://api.mvmnt.io/v1/vendors/{id}
Auth: HTTP bearer

Path parameters

idstring required

Resource ID (UUID) or client key

Response

Vendor found

object'VENDOR'

Object type identifier

idstring uuid required

Unique vendor identifier

friendlyIdstring required

Human-readable vendor identifier

namestring required

Vendor legal name

keystring nullable

Client-defined reference identifier

emailstring email nullable

Primary email address

phonestring nullable

Primary phone number

statusstring nullable

Vendor status

notesstring nullable

Internal notes about the vendor

taxIdstring nullable

Tax identification number

currency'ARS' | 'AUD' | 'BRL' | 'CAD' | 'CNY' | 'EUR' | 'GBP' | 'IDR' | 'INR' | 'JPY' | 'KRW' | 'MXN' | 'RUB' | 'SAR' | 'TRY' | 'USD' | 'ZAR'

Currency code

isMvmntboolean nullable

Whether this vendor is MVMNT itself

requiredDocumentsstring[] nullable

List of required document types

createdAtstring date-time required

When the vendor was created

updatedAtstring date-time required

When the vendor was last updated

deletedAtstring date-time nullable

When the vendor was soft deleted (null if active)

Example response

{
  "object": "VENDOR",
  "id": "550e8400-e29b-41d4-a716-446655440000",
  "friendlyId": "V123456",
  "name": "ABC Warehouse Services",
  "key": "ERP-VENDOR-ABC-001",
  "email": "billing@abcwarehouse.com",
  "phone": "+1-555-123-4567",
  "status": "ACTIVE",
  "notes": "Preferred vendor for warehouse services",
  "taxId": "12-3456789",
  "corporateAddress": {
    "line1": "123 Main St",
    "line2": "Suite 400",
    "city": "Chicago",
    "state": "IL",
    "zipCode": "60601",
    "country": "USA",
    "market": "CHI",
    "latitude": "41.8781",
    "longitude": "-87.6298",
    "isSmartyValidated": true,
    "obeysDst": true
  },
  "billingAddress": {
    "line1": "123 Main St",
    "line2": "Suite 400",
    "city": "Chicago",
    "state": "IL",
    "zipCode": "60601",
    "country": "USA",
    "market": "CHI",
    "latitude": "41.8781",
    "longitude": "-87.6298",
    "isSmartyValidated": true,
    "obeysDst": true
  },
  "paymentTerm": {
    "id": "550e8400-e29b-41d4-a716-446655440000",
    "key": "ERP-PAYTERM-NET30",
    "name": "Net 30",
    "description": "Payment due 30 days from invoice date",
    "days": 30,
    "quickPayFee": 5,
    "createdAt": "2025-01-15T10:00:00Z",
    "updatedAt": "2025-01-15T14:30:00Z"
  },
  "requiredDocuments": [
    "W9",
    "INSURANCE_CERTIFICATE"
  ],
  "paymentMethods": [
    {
      "id": "550e8400-e29b-41d4-a716-446655440000",
      "key": "VENDOR-PM-001",
      "paymentMethodType": "ACH",
      "status": "valid",
      "isPreferred": true,
      "email": "payments@vendor.com",
      "phone": "+1-555-123-4567",
      "companyName": "Vendor Payments LLC",
      "username": "vendor_payments",
      "bankName": "Chase Bank",
      "bankAddress": "123 Bank Street, Dallas, TX 75201",
      "accountName": "Vendor Services Inc",
      "accountNumber": "****1234",
      "abaAch": "021000021",
      "wire": "026009593",
      "swiftCode": "CHASUS33",
      "eftInstitution": "001",
      "eftTransit": "00010",
      "clabe": "012180001234567897",
      "currency": "USD",
      "paymentTerm": {
        "id": "550e8400-e29b-41d4-a716-446655440000",
        "key": "ERP-PAYTERM-NET30",
        "name": "Net 30",
        "description": "Payment due 30 days from invoice date",
        "days": 30,
        "quickPayFee": 5,
        "createdAt": "2025-01-15T10:00:00Z",
        "updatedAt": "2025-01-15T14:30:00Z"
      },
      "createdAt": "2025-01-15T10:00:00Z",
      "updatedAt": "2025-01-15T14:30:00Z",
      "deletedBy": {
        "id": "550e8400-e29b-41d4-a716-446655440000",
        "key": "ERP-USER-12345",
        "email": "john.doe@example.com",
        "name": "John Doe",
        "phone": "+1-555-123-4567",
        "phoneExt": "123",
        "status": "ACTIVE",
        "avatarId": "7c9e6679-7425-40de-944b-e07fc1f90ae7",
        "createdAt": "2025-01-15T10:00:00Z",
        "updatedAt": "2025-01-15T14:30:00Z"
      }
    }
  ],
  "contacts": [
    {
      "object": "VENDOR_CONTACT",
      "id": "550e8400-e29b-41d4-a716-446655440000",
      "key": "ERP-VENDOR-CONTACT-001",
      "email": "john.smith@abcwarehouse.com",
      "phone": "+1-555-123-4567",
      "role": "Billing Manager",
      "roles": [
        "BILLING",
        "AGENT"
      ],
      "deletedBy": {
        "id": "550e8400-e29b-41d4-a716-446655440000",
        "key": "ERP-USER-12345",
        "email": "john.doe@example.com",
        "name": "John Doe",
        "phone": "+1-555-123-4567",
        "phoneExt": "123",
        "status": "ACTIVE",
        "avatarId": "7c9e6679-7425-40de-944b-e07fc1f90ae7",
        "createdAt": "2025-01-15T10:00:00Z",
        "updatedAt": "2025-01-15T14:30:00Z"
      },
      "createdAt": "2025-01-15T10:00:00Z"
    }
  ],
  "deletedBy": {
    "id": "550e8400-e29b-41d4-a716-446655440000",
    "key": "ERP-USER-12345",
    "email": "john.doe@example.com",
    "name": "John Doe",
    "phone": "+1-555-123-4567",
    "phoneExt": "123",
    "status": "ACTIVE",
    "avatarId": "7c9e6679-7425-40de-944b-e07fc1f90ae7",
    "createdAt": "2025-01-15T10:00:00Z",
    "updatedAt": "2025-01-15T14:30:00Z"
  },
  "createdAt": "2025-01-15T10:00:00Z",
  "updatedAt": "2025-01-15T14:30:00Z"
}

Changes

Oct 7, 20262cd6ecfbeb82 Revision changes
- breaking
  removed the required property from the response with the status
- breaking
  removed the required property from the response with the status
- breaking
  removed the required property from the response with the status
- breaking
  removed the required property from the response with the status
- breaking
  removed the required property from the response with the status
- breaking
  removed the required property from the response with the status
- breaking
  removed the required property from the response with the status
- breaking
  removed the required property from the response with the status
- info
  media type application/json was changed to a more specific media type application/problem+json for the response status
- info
  media type application/json was changed to a more specific media type application/problem+json for the response status
- info
  media type application/json was changed to a more specific media type application/problem+json for the response status
- info
  media type application/json was changed to a more specific media type application/problem+json for the response status
- info
  added the optional property to the response with the status
- info
  added the optional property to the response with the status
- info
  added the optional property to the response with the status
- info
  added the optional property to the response with the status
- info
  added the optional property to the response with the status
- info
  added the optional property to the response with the status
- info
  added the optional property to the response with the status
- info
  added the optional property to the response with the status
- info
  added the optional property to the response with the status
- info
  added the optional property to the response with the status
- info
  added the optional property to the response with the status
- info
  added the optional property to the response with the status
- info
  added the optional property to the response with the status
- info
  added the optional property to the response with the status
- info
  added the optional property to the response with the status
- info
  added the optional property to the response with the status
- info
  added the required property to the response with the status
- info
  added the required property to the response with the status
- info
  added the required property to the response with the status
- info
  added the required property to the response with the status
- info
  added the required property to the response with the status
- info
  added the required property to the response with the status
- info
  added the required property to the response with the status
- info
  added the required property to the response with the status
- info
  added the required property to the response with the status
- info
  added the required property to the response with the status
- info
  added the required property to the response with the status
- info
  added the required property to the response with the status
Aug 15, 2026ce0e9003047c Revision changes
- warning
  added the new ARS enum value to the //// response property for the response status
- warning
  added the new AUD enum value to the //// response property for the response status
- warning
  added the new BRL enum value to the //// response property for the response status
- warning
  added the new CNY enum value to the //// response property for the response status
- warning
  added the new IDR enum value to the //// response property for the response status
- warning
  added the new INR enum value to the //// response property for the response status
- warning
  added the new JPY enum value to the //// response property for the response status
- warning
  added the new KRW enum value to the //// response property for the response status
- warning
  added the new RUB enum value to the //// response property for the response status
- warning
  added the new SAR enum value to the //// response property for the response status
- warning
  added the new TRY enum value to the //// response property for the response status
- warning
  added the new ZAR enum value to the //// response property for the response status

Operation history (3 revisions)