ZenHR Inc

ZenHR Inc Business Trips API

The Business Trips API from ZenHR Inc — 6 operation(s) for business trips.

Documentation GitHub OpenAPI

Operations 9

GET /branches/{branch_id}/business_trips 1. View All Business Trips #

POST /branches/{branch_id}/business_trips 3. Create Business Trip #

GET /branches/{branch_id}/business_trips/{business_trip_id} 2. View Business Trip #

PATCH /branches/{branch_id}/business_trips/{business_trip_id} 4. Update Business Trip #

DELETE /branches/{branch_id}/business_trips/{business_trip_id} 5. Delete Business Trip #

GET /branches/{branch_id}/business_trips/travel_types 6. View Available Travel Types #

GET /branches/{branch_id}/business_trips/destinations_cities 7. View Available Destination Cities #

GET /branches/{branch_id}/business_trips/all_available_arrivals 8. View Available Arrival Cities #

GET /branches/{branch_id}/business_trips/destinations_data 9. View Available Destinations #

Specifications

⚙

OpenAPI

https://raw.githubusercontent.com/api-evangelist/zenhr-inc/refs/heads/main/openapi/zenhr-inc-business-trips-api-openapi.yml

Other Resources

🔗

Postman

https://raw.githubusercontent.com/api-evangelist/zenhr-inc/refs/heads/main/openapi/zenhr-inc-postman-collection.json

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/zenhr-inc-business-trips-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.

GitHub Google LinkedIn

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

OpenAPI Specification

openapi: 3.2.0
info:
  title: ZenHR Approvals Business Trips API
  version: v3
  description: REST API for the ZenHR HR & payroll platform. Integrate external applications with ZenHR to manage branches, employees, master/professional/financial data, payroll (salaries, financial transactions, loans, overtime), time off, attendance, competencies, HR letters, terminations, business travel, and documents. Responds in JSON with standard HTTP status codes; authenticated via OAuth 2.0 (authorization code + PKCE). Derived by API Evangelist from the provider's published Postman documentation collection.
  contact:
    name: ZenHR DevOps
    email: devops@zenhr.com
    url: https://api-docs.zenhr.com/
  x-apievangelist-source: https://api-docs.zenhr.com/ (Postman published collection 2sA3dxDWwR)
servers:
- url: https://app.zenhr.com/api/v3
  description: Production
- url: https://aiapi.zenhr.com/api/v3
  description: Attendance ingestion (AI) host
security:
- oauth2:
  - read:employee
tags:
- name: Business Trips
paths:
  /branches/{branch_id}/business_trips:
    get:
      summary: 1. View All Business Trips
      tags:
      - Business Trips
      operationId: 1ViewAllBusinessTrips
      responses:
        '200':
          description: Successful response
        '401':
          description: Unauthorized
        '404':
          description: Not found
      parameters:
      - name: branch_id
        in: path
        required: true
        schema:
          type: string
    post:
      summary: 3. Create Business Trip
      tags:
      - Business Trips
      operationId: 3CreateBusinessTrip
      responses:
        '200':
          description: Successful response
        '401':
          description: Unauthorized
        '404':
          description: Not found
      parameters:
      - name: branch_id
        in: path
        required: true
        schema:
          type: string
      requestBody:
        content:
          application/json:
            schema:
              type: object
            example:
              business_trip:
                category: international
                employee_id: 1159
                departure_city_id: 152
                arrival_city_id: 472
                start_date: '2025-06-17'
                end_date: '2025-06-18'
                with_accommodation: true
                notes: Szia
                extra_expenses_attributes:
                - _destroy: false
                  amount: 1200
                  amount_currency: SAR
                  financial_transaction_type_id: 1748
                - _destroy: false
                  amount: 24000
                  amount_currency: SAR
                  financial_transaction_type_id: 1748
                - _destroy: false
                  amount: 4800000
                  amount_currency: SAR
                  financial_transaction_type_id: 1748
  /branches/{branch_id}/business_trips/{business_trip_id}:
    get:
      summary: 2. View Business Trip
      tags:
      - Business Trips
      operationId: 2ViewBusinessTrip
      responses:
        '200':
          description: Successful response
        '401':
          description: Unauthorized
        '404':
          description: Not found
      parameters:
      - name: branch_id
        in: path
        required: true
        schema:
          type: string
      - name: business_trip_id
        in: path
        required: true
        schema:
          type: string
    patch:
      summary: 4. Update Business Trip
      tags:
      - Business Trips
      operationId: 4UpdateBusinessTrip
      responses:
        '200':
          description: Successful response
        '401':
          description: Unauthorized
        '404':
          description: Not found
      parameters:
      - name: branch_id
        in: path
        required: true
        schema:
          type: string
      - name: business_trip_id
        in: path
        required: true
        schema:
          type: string
    delete:
      summary: 5. Delete Business Trip
      tags:
      - Business Trips
      operationId: 5DeleteBusinessTrip
      responses:
        '200':
          description: Successful response
        '401':
          description: Unauthorized
        '404':
          description: Not found
      parameters:
      - name: branch_id
        in: path
        required: true
        schema:
          type: string
      - name: business_trip_id
        in: path
        required: true
        schema:
          type: string
  /branches/{branch_id}/business_trips/travel_types:
    get:
      summary: 6. View Available Travel Types
      tags:
      - Business Trips
      operationId: 6ViewAvailableTravelTypes
      responses:
        '200':
          description: Successful response
        '401':
          description: Unauthorized
        '404':
          description: Not found
      parameters:
      - name: branch_id
        in: path
        required: true
        schema:
          type: string
  /branches/{branch_id}/business_trips/destinations_cities:
    get:
      summary: 7. View Available Destination Cities
      tags:
      - Business Trips
      operationId: 7ViewAvailableDestinationCities
      responses:
        '200':
          description: Successful response
        '401':
          description: Unauthorized
        '404':
          description: Not found
      parameters:
      - name: branch_id
        in: path
        required: true
        schema:
          type: string
  /branches/{branch_id}/business_trips/all_available_arrivals:
    get:
      summary: 8. View Available Arrival Cities
      tags:
      - Business Trips
      operationId: 8ViewAvailableArrivalCities
      responses:
        '200':
          description: Successful response
        '401':
          description: Unauthorized
        '404':
          description: Not found
      parameters:
      - name: branch_id
        in: path
        required: true
        schema:
          type: string
  /branches/{branch_id}/business_trips/destinations_data:
    get:
      summary: 9. View Available Destinations
      tags:
      - Business Trips
      operationId: 9ViewAvailableDestinations
      responses:
        '200':
          description: Successful response
        '401':
          description: Unauthorized
        '404':
          description: Not found
      parameters:
      - name: branch_id
        in: path
        required: true
        schema:
          type: string
components:
  securitySchemes:
    oauth2:
      type: oauth2
      flows:
        authorizationCode:
          authorizationUrl: https://api.zenhr.com/en/oauth/authorize
          tokenUrl: https://api.zenhr.com/en/oauth/token
          scopes:
            read:branch: Read branch data
            read:employee: Read employee data
            accessed_employees_branches:employee: Access employees within permitted branches
            read:professional_info: Read employee professional information
            read:termination: Read termination data
            read:employee_disciplinary_actions: Read employee disciplinary actions
            read:financial_transaction: Read financial transactions
            read:performance_evaluation: Read performance evaluations
            read:timeoff_transaction: Read time-off transactions