Guide
  • SDK

    • PHP
    • .NET
  • Postman

    • Postman Collection
Api Docs
Guide
  • SDK

    • PHP
    • .NET
  • Postman

    • Postman Collection
Api Docs
  • Getting Started

    • Getting Started
    • Integration process
  • Tools and libraries

    • SDK for PHP
    • SDK for .NET
    • Postman Collection
  • Fundamentals

    • Authorization
    • Errors
    • Extensions
    • Rate Limits
  • API Objects

    • Resources
    • Managing calendars
    • Online Features
    • Patient Presence
  • Callbacks

    • Push vs Pull
    • Real-time requests
  • Mappings

    • Vendor mapping
  • Changelog

    • Changelog
DOCPLANNER INTEGRATIONS

Errors

Docplanner uses standard HTTP response codes to indicate the outcome of API requests, reflecting the success or failure of each interaction.

Docplanner API responses use conventional HTTP status codes:

  • Codes in the 2xx range indicate success.
  • Codes in the 4xx range indicate client-side errors (such as invalid input, missing fields, or unavailable resources).
  • Codes in the 5xx range indicate server-side errors.

Monitor Docplanner Service Status

You can monitor our service uptime and any incidents via our status page.

HTTP Status Codes

Below is a summary of key HTTP status codes used in the Docplanner API:

Status CodeDescription
200Success – The request was processed successfully.
201Created – A new resource has been successfully created.
204No Content – The request was successful, but there's no content in the response.
400Bad Request – The request was malformed or contained invalid data.
401Unauthorized – Request failed due to invalid or missing authentication credentials.
403Forbidden – Access to the requested resource or action is denied.
404Not Found – The requested resource does not exist (possibly deleted).
405Method Not Allowed – The HTTP method used is not supported for this endpoint.
409Conflict – The request conflicts with the current state of the server (e.g., duplicate resource).
429Too Many Requests – Rate limit exceeded. Learn more here.
500/502/503/504Server Error – An error occurred on Docplanner's side (should be rare).

All error responses include a specific Content-Type header:

Content-Type: application/vnd.error+docplanner+json

Custom Error Messages

In real-time booking scenarios, you can configure the booking flow to respond with custom error messages based on synchronous calls (see details here).

When an error response with a code from the 4xx family and the header Content-Type: application/json is returned, the body should contain a specific error_code, as defined in the dictionary provided by Docplanner Integrations Support (contact: integrations@docplanner.com).

Example:

{
    "error_code": 1
}

This will result in a customized error message being displayed to the patient during the booking process:

Note: When custom error messaging is used, the booking will not be completed, and the appointment will not be created in Docplanner.

Prev
Authorization
Next
Extensions