The Wonolo API (V2.0) is a RESTful API to perform CRUD operations on Wonolo platform resources.

Currently, JSON is the only encoding format supported.

API Keys

Use of the Wonolo API requires keys. To obtain API keys, please apply here.

Test and Production Environments

You will be issued with two sets of API keys:

Security / HTTPS

All API calls must be made over HTTPS. With the exception of /authenticate and /info, all API calls must use an authorization token (passed as the token parameter).

Getting Started

Once you receive your API keys, the first step is to authenticate to obtain a token for use with subsequent API calls. Please refer to the /api_v2/authenticate endpoint documentation below.


A qualification or skill that is required to accept a particular Job Request

Resource Description
GET /api_v2/badges List available Badges
GET /api_v2/badges/:id Get a specific Badge


Resource Description
GET /api_v2/info Get API information

Job requests
A request for Wonoloers to perform a Job

Resource Description
GET /api_v2/job_requests List JobRequests
POST /api_v2/job_requests Create a JobRequest
PATCH /api_v2/job_requests/:id Update a JobRequest
GET /api_v2/job_requests/:id Get a specific JobRequest
GET /api_v2/job_requests/:id/rankings List the Wonoloers that are ranked for this JobRequest
POST /api_v2/job_requests/:id/resend_notifications Resend notifications for this JobRequest

A Wonoloer performing a Job Request

Resource Description
GET /api_v2/jobs List Jobs
POST /api_v2/jobs Create a Job
PATCH /api_v2/jobs/:id Update a Job
GET /api_v2/jobs/:id Get a specific Job

An In-app Message between a Requestor and a Wonoloer

Resource Description
GET /api_v2/messages List Messages
POST /api_v2/messages Create a Message
GET /api_v2/messages/:id Get a specific Message

Multi day job requests
A Job Request that spans multiple days.

Resource Description
POST /api_v2/multi_day_job_requests Create a Multi-day Job Request
PATCH /api_v2/multi_day_job_requests/:id Update a Multi-day Job Request
GET /api_v2/multi_day_job_requests/:id Get a specific Multi-day Job Request

Search Wonolo models

Resource Description
GET /api_v2/search Search Wonolo


Resource Description
POST /api_v2/authenticate Authenticate and obtain a token

Users - Wonoloers and Requestors

Resource Description
GET /api_v2/users List users
POST /api_v2/users Create a user
PATCH /api_v2/users/:id Update a user
GET /api_v2/users/:id Get a specific user
GET /api_v2/users/:id/tracking Get tracking data for a specific user