---
nav: wcp_docs
parent_url: /wcp_docs/
title: REST APIs in Apps and Integrations
layout: subsection
---

Extend apps, Integration apps, and Integrations that call Workday REST APIs use the [API Gateway base URLs](/wcp_docs/dlh1653340161856.html) that correspond to the company's region. Example: `https://api.workday.com or https://api.us.wcp.workday.com` for the United States.

<b>Note:</b> Don't use tenant base paths when calling Workday REST APIs with Extend and Orchestrate.

## <a id="section_integrations"></a>REST APIs in Extend Apps

Extend app components fundamentally interact with REST APIs to access data.

-   REST inbound and outbound endpoints.

    In App Builder, your app data providers are REST services, including Workday REST services and third-party REST APIs. App pages call REST endpoints to load and submit data, using JSON for all data interchange.

-   Generated REST APIs for Extend business objects and business processes.

    When you create business objects and business processes in your Extend app, Workday generates full-featured REST APIs for them. This is a core feature of the platform and is the primary way you will interact with your app's data.

-   Orchestration.

    Extend apps can use Orchestration Builder to create complex, event-driven workflows. These orchestrations can call both Workday REST APIs and external third-party APIs, allowing you to build sophisticated business processes that span multiple systems.



See [Getting Started with Extend Apps](/wcp_docs/GUID-04def314-83a7-4edf-b84c-c0a5f005b23c-enHYPHENus.html) and [Call Workday REST APIs in Extend Apps](/wcp_docs/gya1560920237072.html).

## <a id="section_extend"></a>REST APIs in Integration Apps

Integration apps contain orchestrations that can call REST APIs for integration workflows, data transformations, and data exchanges between Workday and external systems.

-   API-driven workflows.

    Orchestrations are built by connecting a series of steps, many of which are API calls. You can use a drag-and-drop interface to call Workday REST APIs, SOAP services, or external APIs.

-   Data transformations.

    A key feature of Orchestrate is its ability to easily transform data between different formats. Example: You can take the JSON output from a REST API call and map it to the XML format required by a SOAP service.

-   Real-time, event-driven processes.

    Orchestrations are purpose-built for creating real-time, event-driven integrations. Example: A business process event in Workday can trigger an orchestration, then call a series of APIs to update data in multiple external systems, and finally send a notification back to Workday.



See [Getting Started with Integration Apps](/wcp_docs/GUID-1293c9bb-ea02-48cd-a523-254b5060b3a6-enHYPHENus.html) and [Concept: Data Requests Components in Integration Apps](/wcp_docs/GUID-1d80c5d4-ef12-4ecf-aec1-7fc287500bd2.html).

## <a id="section_orchestrate"></a>REST APIs in Integrations

In the context of traditional Integrations, REST APIs are one of several tools available for getting data into and out of Workday.

-   Complementary to Workday SOAP APIs.

    While Workday SOAP APIs are generally favored for large, scheduled, system-to-system data transfers, Workday REST APIs are better suited for smaller, user-initiated transactions. Use Workday REST APIs for low-latency requests and responses involving small amounts of data, and not for bulk data export or import. Examples: A mobile app or a web portal that needs to quickly fetch or update specific worker information. Use also for cases where no equivalent SOAP API exists. Example: As part of its processing, a bulk integration must retrieve attachments from business process events using the [Business Process Events REST API](https://developer.workday.com/rest-api-explorer/docs#businessProcess/v1/events).

-   Reports-as-a-Service (RaaS).

    Reports-as-a-Service (RaaS) enables you to expose a Workday custom report as a RESTful web service. It enables external systems to call the report's URL and receive the data in either XML or JSON format. This is a highly flexible way to create custom outbound integrations.

-   Integration with external REST APIs.

    Integrations can also call external, third-party REST APIs. Orchestrate for Integrations is a low-code development tool for building complex integration workflows that can facilitate external REST API calls.



See [Administrator Guide: Integrations](https://doc.workday.com/admin-guide/en-us/integrations/pmt1545076237838.html).