Supplier API Overview

The Supplier API exposes engagement, billing, worker, timecard, and candidate-insight capabilities to support automated workflows and integrations between your systems and Magnit VMS. It is intended for supplier organizations that want to consume VMS data programmatically rather than only through the supplier UI.

Capabilities

  • Engagements — read engagement details for engagements your organization is associated with.
  • Billing — read billing items and invoice details.
  • Workers — create and update worker profiles.
  • Timecards — create and update worker timecards.
  • Candidate Pre-Submittal Insights — retrieve Maggi AI scoring and match analysis for a candidate before submission, so you can decide whether to proceed with the submittal.

Authentication

The Supplier API uses the same user-level API key as the RaaS API. Generate or retrieve a key from your User Profile; see Set Up a User API Key. Select the Supplier API scopes during key generation.

Note:
The Supplier API must be enabled by the MSP for your client. If the API endpoints return a 403, ask your MSP to enable the integration in App Integrations.

Documentation

For endpoint reference, payloads, and rate limits, see Supplier API Endpoints. The OpenAPI / Swagger specification and the Getting Started Guide are published separately and are linked from there.