Skip to content

PROPSERV FOR DEVELOPERS

Your systems.
Our platform.
Connected.

Bring property maintenance into the tools you already use. Build around your agency’s data with the PropServ External API.

Explore the reference
YOUR FIRST REQUESTcURL

Start with a work request.

curl "https://api.propfees.co/api/external/submissions" \
  -H "Authorization: Bearer YOUR_COMPANY_API_TOKEN" \
  -H "Accept: application/json"
Bearer token → JSON response

Example only · add your own company API token

Bearer token authenticationLive marketplace dataInteractive reference

01 — GETTING STARTED

A few steps.
A lot of possibility.

API access is included with the Ultimate plan. Creating work requests is enabled by PropServ on request.

  1. 01

    Create an API token

    An admin user on your account can create tokens in the agent portal under Settings → Integrations & API → API. Tokens belong to your company, so one token covers your whole agency. Each token can expire after 30, 90, 180 or 365 days, or never; expired and revoked tokens are refused with a 401.

  2. 02

    Choose its permissions

    Every token needs the read:submission-responses permission to read anything — a token without it gets a 403 on every read endpoint. If you plan to create work requests through the API, also grant the token the write:submissions permission when you create it.

  3. 03

    Request write access

    Creating work requests is enabled per company by PropServ and is not granted automatically. Ask your PropServ account manager, or email info@propserv.co, to have it switched on. Skip this step if you only need read access.

  4. 04

    Make your first request

    Send your token as a Bearer token in the Authorization header, along with Accept: application/json. Every response is JSON, and list endpoints are paginated.

Need to write to PropServ?

Ask your account manager to enable company write access, then give your token the write:submissions permission alongside Read.

Request access

CHOOSE YOUR ENVIRONMENT

01 / PRODUCTION

Ready for the everyday.

https://api.propfees.co/api
02 / DEVELOPMENT

Room to experiment.

https://dev.api.propfees.co/api

Contact us for development credentials.

02 — THE BUILDING BLOCKS

The whole workflow.
Over JSON.

Six resource groups connect the people, properties and work across your agency.

Work requests

Read every work request your agency has raised — and create new ones straight from your own system.

  • GET/external/submissions
  • GET/external/submissions/{uuid}
  • GET/external/submissions/{uuid}/responses
  • POST/external/submissionsOn request

Contractor responses

Quotes, callouts and declines from contractors, with pricing, documents and status history.

  • GET/external/submission-responses
  • GET/external/submission-responses/{uuid}

Tenant reports

Issues reported by tenants, including triage answers, categories and attached media.

  • GET/external/tenant-reports
  • GET/external/tenant-reports/{uuid}

Tenants & users

The people on your account — tenants linked to your agency and the users in your company.

  • GET/external/tenants
  • GET/external/users
  • GET/external/users/{uuid}

Reference data

Categories and properties — everything you need to build a valid work request payload.

  • GET/external/categories
  • GET/external/properties

Token management

Create, list and revoke company API tokens. Uses an admin's own PropServ login, not a company token.

  • GET/external-api/tokens
  • POST/external-api/tokens
  • DELETE/external-api/tokens/{tokenId}
  • DELETE/external-api/tokens

03 — API REFERENCE

Get into
the details.

Explore request parameters, payload schemas and example responses in the interactive OpenAPI reference.

PropServ External API · OpenAPI 3.0Download the spec

Building something good?

Talk to our team about connecting your agency’s tools.

Let’s talk