Skip to main content
The Symmetry Minimum Wage Finder (MWF) API returns applicable minimum wage rates for a work location or minimum wage unique ID (mwUid) across all industries, at any point in time, in JSON. The endpoint reference in this section is generated from the MWF OpenAPI specification.
New to the MWF API? Start with the Quickstart: Call the MWF API for a complete first request, then use this reference for full endpoint and schema details.

​
Environments and base URLs

The endpoints that return rates are /mwf/v1/location, /mwf/v1/id, and /mwf/v1/rates/effective.
Always develop and test against the staging environment before pointing your integration at production.

​
Authentication

Every MWF endpoint other than /authentication/login requires a JWT access token. Request one by sending an HTTP GET to your apiDomain URL with the api-key header set to the API key Symmetry provided, then send the token back as a Bearer token in the Authorization header.
A successful response contains the access token:
Tokens are valid for 24 hours. An invalid, expired, or empty token produces an HTTP 401:
Access token versus API keyYour access token is not the same as your API key. Your API key is used for initial authentication to obtain an access token from the /authentication/login endpoint. Your access token is used for authorization to access and interact with other MWF API endpoints securely.

​
Explore in Swagger

API clients can access our Swagger documentation to test and explore each endpoint, and see a comprehensive overview of all available features. Our Swagger docs are available for both our production and staging environments.

​
Authorize access to Swagger docs

To generate the token, make a request to the /authentication/login endpoint to receive a valid access token. Then click the Authorize button on the right side of the browser, enter this access token into the dialog box for the respective environment, and click Authorize.
Once authorized successfully, you’ll see an unlocked symbol appear on each of the endpoints. This is your indication that you can send the sample requests to each endpoint.
Click into the desired endpoint, select Try it out, and then Execute.
You’ll then receive the response from the endpoint.

​
Next steps

Postman

Download the MWF Postman collection and environment directly from the API.

Endpoints

Full reference for every minimum wage, documentation, and Postman endpoint.