Cadasto User API

User information and caseload for the authenticated user.

Operations 2

GET /extra/v1/user/info Get user info #
GET /extra/v1/user/caseload Get user caseload #

Work with this as data

Every API here is available over the APIs.io API and to AI agents over MCP.

MCP server

One button, every client — Claude, Cursor, VS Code and the rest.

https://apis.io/mcp

Tools for apis

7 MCP tools reach this
  • find_apisBrowse and filter every API in the catalog.
  • get_api_artifactsOne API's artifacts, grouped by type.
  • get_openapiThe primary OpenAPI for this API.
  • find_similar_apisAPIs that look like this one.
  • apis_io_searchSTART HERE — APIs, providers and tags for one query, each with its total.
  • resolveTurn a domain, URL or GitHub org into the provider it belongs to.
  • find_cohortsEvery scored population of providers in the catalog.
All 92 tools →

Call it yourself

curl for this page
This API
curl "https://apis.io/api/v1/apis/cadasto-user-api"
All apis
curl "https://apis.io/api/v1/apis?limit=25"

Discovery needs no key. Ratings and market analysis are Pro.

Get an API key

Free tier, no form to fill in. Signing in shares your email address with us — we store it to create your key and to recognise you if you sign in with another provider. See our Privacy Policy and Terms.

A second provider on the same verified email joins the account you already have.

OpenAPI Specification

cadasto-user-api-openapi.yml Raw ↑
openapi: 3.2.0
info:
  title: Cadasto Additional User API
  version: 1.0.0
  description: 'Additional API on top of the openEHR REST API, specific to Cadasto.

    The endpoints in this specification are Cadasto-specific and are intended

    to make it easier for app builders to interact with openEHR (e.g. datamaps).

    This API only works within Cadasto.'
servers:
- url: https://api.customer.cadasto.io
security:
- bearerAuth: []
tags:
- name: User
  description: User information and caseload for the authenticated user.
paths:
  /extra/v1/user/info:
    get:
      tags:
      - User
      summary: Get user info
      description: Returns basic information about the authenticated user.
      parameters:
      - $ref: '#/components/parameters/role'
      - $ref: '#/components/parameters/identifier'
      - $ref: '#/components/parameters/identifierType'
      responses:
        '200':
          description: OK
          content:
            application/json:
              schema:
                type: object
            examples:
              patient:
                summary: Patient lookup
                value:
                  id: <redacted>
                  fhir_patient_id: <redacted>
                  ehr_id: <redacted>
                  profile:
                    name: Arie Achterweg
                    nickname: Arie
                    email: arie@code24.nl
                    birth_date: '19840513'
                    patientId: '9999999001'
                  role:
                    id: <redacted>
                    all:
                    - uid: <redacted>
                      name: Patient
                  success: true
              practitioner:
                summary: Practitioner lookup
                value:
                  id: <redacted>
                  fhir_patient_id: <redacted>
                  ehr_id: ''
                  profile:
                    name: Denillo Valkenier
                    nickname: Denillo
                    email: null
                    birth_date: '19710530'
                    patientId: null
                  role:
                    id: <redacted>
                    all:
                    - uid: <redacted>
                      name: Zorgverlener
                  success: true
        '400':
          description: Bad request
          content:
            application/json:
              schema:
                type: object
              examples:
                default:
                  value:
                    message: Bad request.
                    errors:
                    - ' => The ''role'' parameter is required.'
                    - ' => The ''identifier'' parameter is required.'
                    - ' => The ''identifierType'' parameter is required.'
                    exception:
                    - type: Code24\\Slim\\Http\\Exception\\HttpBadRequestException
                      code: 400
                      message: Bad request.
                      file: /app/src/Controller/UserController.php
                      line: 82
        '404':
          description: Not found
          content:
            application/json:
              schema:
                type: object
              examples:
                default:
                  value:
                    message: User not found.
                    exception:
                    - type: Slim\\Exception\\HttpNotFoundException
                      code: 404
                      message: User not found.
                      file: /app/src/Controller/UserController.php
                      line: 100
      operationId: getExtraV1UserInfo
      x-operation-id-source: derived
  /extra/v1/user/caseload:
    get:
      tags:
      - User
      summary: Get user caseload
      description: Returns the caseload of the authenticated user.
      responses:
        '200':
          description: OK
          content:
            application/json:
              schema:
                type: object
              examples:
                default:
                  value:
                    totalCount: 0
                    patients: []
      operationId: getExtraV1UserCaseload
      x-operation-id-source: derived
components:
  parameters:
    role:
      name: role
      in: query
      required: true
      schema:
        type: string
        enum:
        - patient
        - practitioner
      description: User role to resolve (patient or practitioner).
    identifier:
      name: identifier
      in: query
      required: true
      schema:
        type: string
      description: Identifier value to resolve to a user.
    identifierType:
      name: identifierType
      in: query
      required: true
      schema:
        type: string
      description: Identifier type. Use `partyUid` when providing a UUID.
  securitySchemes:
    bearerAuth:
      type: http
      scheme: bearer
      bearerFormat: JWT
x-ext-urls: {}