Using our API

ServeManager has a robust developer API which can be used to integrate with your system, a client’s, or third-party applications.

What you can do with the API

The API gives you programmatic access to most of what you manage in ServeManager, including:

• Jobs — create, retrieve, update, and manage service jobs
• Companies — manage client and process server company profiles, contacts, and addresses
• Employees — access employee information and permissions on your account
• Court cases & courts — manage case and court location data
• Attempts — track service attempts, including details, GPS data, and attachments
• Invoices — create and manage billing
• Documents — upload and manage service documents and attachments
• Webhooks — receive real-time notifications when job events happen, instead of polling for updates

Generate your own API key

You can generate your own API key directly from your account — no need to email support for one.

Go to My Account → Settings → Manage (under the integrations section) to create a key. You can generate a separate key for each integration you connect, give each one a title, and see its usage history and last-accessed date.

Treat your API key like your login credentials: keep it secret, and avoid reusing the same key across multiple integrations. If you ever suspect a key has been exposed, generate a new one and delete the old one — since each integration has its own key, this limits the impact to that one connection.

The basics for making requests

A few things to know before you start building:

• Authentication: Requests use HTTP Basic Authentication, with your API key as the username and an empty password.
• SSL required: All requests must use SSL, with a base URL of https://www.servemanager.com/.
• Format: Requests and responses use JSON. Include a Content-Type: application/json header on POST, PUT, and PATCH requests.
• Dates: Use ISO 8601 format (for example, 2013-02-27 or 2013-02-27T15:18:23-04:00).
• Pagination: Index endpoints are paginated, with a maximum of 100 results per page.

Learn more

Detailed instructions, including full endpoint references, can be found in our API Documentation, and you can generate your own API key by following this guide.