Workday Strategic Sourcing Reports API (1.0)

Download OpenAPI specification:

Customer Support

We've provided detailed documentation below to guide you. However, if you need additional assistance, here's how you can get the support you need:

  • Community Discussions: Join the conversation on our Workday Community Discussion Boards (found under the "Collaborate" section in community). Connect with other users, share best practices, and get answers to your configuration questions.
  • Expert Configuration Assistance (Professional Services): For tailored, hands-on support with your specific project, our Professional Services team is available.
    • Looking for personalized guidance? Workday Success Plan customers can submit an "Ask" for expert insights on configuration and best practices.
    • Need custom solutions? Consider Expert Assist, our consulting service for detailed changes and project support.
  • Reporting System Issues: If you suspect a problem with the Workday system itself, please connect with our dedicated support team. Your company's Named Support Contact (NSC) can log a Product Support Defect case. We'll review the issue based on its impact and Workday's service level agreement (SLA).

Servers

A corresponding "region domain" should be used on every request. Please contact customer support if you are not sure which one to use.

Note, our original domain api.scoutrfp.com is currently deprecated. Please switch to a new US region domain on or before April-2025.

Region Domain
US (Default) https://api.us.workdayspend.com
Canada https://api.ca.workdayspend.com
Europe/EU https://api.eu.workdayspend.com

API Specification

The API conforms to the JSON API Specification.

Authentication

The Workday Strategic Sourcing API uses API keys to authenticate requests. Every request will require all 3 HTTP headers:

HTTP Header Description
X-Api-Key a company-wide API key
X-User-Token a user-specific API token
X-User-Email user email

You can generate all of those from the API tokens section of your Profile page.

Your API keys carry many privileges, so be sure to keep them secure! Do not share your secret API keys in publicly accessible areas such as GitHub, client-side code, and so forth.

All API requests must be made over HTTPS. Calls made over plain HTTP will fail. API requests without authentication will also fail.

Rate Limiting

Rate limit windows are per second and are shared by all API Keys for a company.

The rate limit for reporting only is 1 request per second.

When request submissions exceed the limits, the limit-exceeding requests return 429 Too Many Requests error responses to the client.

Upon receiving a 429 response, it is recommended to retry the request in compliance with the rate limit. One example would be to add a sleep function for 1 second and retry.

Versioning

Note: The Reporting API handles versioning differently than our public APIs.

We release a new dated version when we make backwards incompatible changes to the API. So to be sure that the version used is consistent, we require it to be supplied in the request Accept header mime type com.workdayspend.api.version parameter.

As the JSON API spec requires to supply its mime type at least once with no parameters, the recommended way is to supply the Accept header as follows:

  application/vnd.api+json,application/vnd.api+json; com.workdayspend.api.version=2019-01-01

The next Accept header will be deprecated in April-2025:

  application/vnd.api+json,application/vnd.api+json; com.scoutrfp.api.version=2019-01-01

where 2019-01-01 is the current version.

There is 2018-04-01 version still available, which allows to pass given report id as a parameter (See 2018-04-01 Projects or Events documentation), however it might be depricated without a warning.

Pagination

The list endpoints are paginated - the records are returned in batches of 10 by default. You can change this amount by passing the page[size] parameter that supports values from 1 to 100. If the previous/next page is available for the requested records, the prev/next key respectively has a value with a link to the corresponding page in the top level links object of the response. Otherwise, if the next/previous page is not available, the value for the corresponding key is null. So normally you would fetch the record with the standard URL and repeatedly fetch the next page till it is not available any more (which means that you have fetched all the pages).

Sorting

The results of each list endpoint are sorted by its default sort value. You can override the sort value by passing the sort param to the request. Default and available values are visible in the documentation list endpoint section of each resource.

Including Relationships

By default only the id and type of record relationships will be included. To include other attributes in the response, use the include parameter with a single value or multiple comma-separated values. An array of relationship objects is then available under the top level included key. Valid include values are noted in the documentation endpoint section of each resource.

Contract Milestone Reports

This report returns a list of contract milestone report entries.

Contract Milestone Report Entries

Returns a list of milestone report entries.

Authorizations:
(api_keyuser_tokenuser_email)

Responses

Request samples

curl -H "X-Api-Key: ${COMPANY_KEY}" \
     -H "X-User-Token: ${USER_TOKEN}" \
     -H "X-User-Email: ${USER_EMAIL}" \
     -H "Content-Type: application/vnd.api+json" \
     -H "Accept: application/vnd.api+json,application/vnd.api+json; com.workdayspend.api.version=2019-01-01"
     "https://api.us.workdayspend.com/contract_milestone_reports/entries"

Response samples

Content type
application/vnd.api+json
{
  • "data": [
    ],
  • "links": {
    }
}

Contract Milestone Report Schema

Returns the contract milestone report schema.

Authorizations:
(api_keyuser_tokenuser_email)

Responses

Request samples

curl -H "X-Api-Key: ${COMPANY_KEY}" \
     -H "X-User-Token: ${USER_TOKEN}" \
     -H "X-User-Email: ${USER_EMAIL}" \
     -H "Content-Type: application/vnd.api+json" \
     -H "Accept: application/vnd.api+json,application/vnd.api+json; com.workdayspend.api.version=2019-01-01"
     "https://api.us.workdayspend.com/contract_milestone_reports/schema"

Response samples

Content type
application/vnd.api+json
{
  • "data": {
    }
}

Contract Reports

This report returns a list of contract report entries.

Contract Report Entries

Returns a list of contract report entries.

Authorizations:
(api_keyuser_tokenuser_email)

Responses

Request samples

curl -H "X-Api-Key: ${COMPANY_KEY}" \
     -H "X-User-Token: ${USER_TOKEN}" \
     -H "X-User-Email: ${USER_EMAIL}" \
     -H "Content-Type: application/vnd.api+json" \
     -H "Accept: application/vnd.api+json,application/vnd.api+json; com.workdayspend.api.version=2019-01-01"
     "https://api.us.workdayspend.com/contract_reports/entries"

Response samples

Content type
application/vnd.api+json
{
  • "data": [
    ],
  • "links": {
    }
}

Contract Report Schema

Returns the contract report schema.

Authorizations:
(api_keyuser_tokenuser_email)

Responses

Request samples

curl -H "X-Api-Key: ${COMPANY_KEY}" \
     -H "X-User-Token: ${USER_TOKEN}" \
     -H "X-User-Email: ${USER_EMAIL}" \
     -H "Content-Type: application/vnd.api+json" \
     -H "Accept: application/vnd.api+json,application/vnd.api+json; com.workdayspend.api.version=2019-01-01"
     "https://api.us.workdayspend.com/contract_reports/schema"

Response samples

Content type
application/vnd.api+json
{
  • "data": {
    }
}

Event Reports

This report returns a list of event report entries.

Event Report Entries

Returns a list of event report entries.

Authorizations:
(api_keyuser_tokenuser_email)

Responses

Request samples

curl -H "X-Api-Key: ${COMPANY_KEY}" \
     -H "X-User-Token: ${USER_TOKEN}" \
     -H "X-User-Email: ${USER_EMAIL}" \
     -H "Content-Type: application/vnd.api+json" \
     -H "Accept: application/vnd.api+json,application/vnd.api+json; com.workdayspend.api.version=2019-01-01"
     "https://api.us.workdayspend.com/event_reports/entries"

Response samples

Content type
application/vnd.api+json
Example
{
  • "data": [
    ],
  • "links": {
    }
}

Event Single Report Entries

Returns a list of event report entries.

Authorizations:
(api_keyuser_tokenuser_email)
path Parameters
event_report_id
required
integer
Example: 1

Unique Event Report identifier.

Responses

Request samples

curl -H "X-Api-Key: ${COMPANY_KEY}" \
     -H "X-User-Token: ${USER_TOKEN}" \
     -H "X-User-Email: ${USER_EMAIL}" \
     -H "Content-Type: application/vnd.api+json" \
     -H "Accept: application/vnd.api+json,application/vnd.api+json; com.workdayspend.api.version=2019-01-01"
     "https://api.us.workdayspend.com/event_reports/{event_report_id}/entries"

Response samples

Content type
application/vnd.api+json
Example
{
  • "data": [
    ],
  • "links": {
    }
}

Event Report Entries (Deprecated)

Returns a list of reports owned by the user.

This report endpoint is only valid in version 2018-04-01.

It is deprecated and unavailable in subsequent versions.

Authorizations:
(api_keyuser_tokenuser_email)

Responses

Request samples

curl -H "X-Api-Key: ${COMPANY_KEY}" \
     -H "X-User-Token: ${USER_TOKEN}" \
     -H "X-User-Email: ${USER_EMAIL}" \
     -H "Content-Type: application/vnd.api+json" \
     -H "Accept: application/vnd.api+json,application/vnd.api+json; com.workdayspend.api.version=2018-04-01"
     "https://api.us.workdayspend.com/event_reports"

Response samples

Content type
application/vnd.api+json
{}

Event Report Schema

Returns the event report schema.

Authorizations:
(api_keyuser_tokenuser_email)

Responses

Request samples

curl -H "X-Api-Key: ${COMPANY_KEY}" \
     -H "X-User-Token: ${USER_TOKEN}" \
     -H "X-User-Email: ${USER_EMAIL}" \
     -H "Content-Type: application/vnd.api+json" \
     -H "Accept: application/vnd.api+json,application/vnd.api+json; com.workdayspend.api.version=2019-01-01"
     "https://api.us.workdayspend.com/event_reports/schema"

Response samples

Content type
application/vnd.api+json
{
  • "data": {
    }
}

Performance Review Answer Reports

This report returns a list of Performance Review Answer report entries.

Performance Review Answer Report Entries

Returns a list of performance review answer entries.

Authorizations:
(api_keyuser_tokenuser_email)

Responses

Request samples

curl -H "X-Api-Key: ${COMPANY_KEY}" \
     -H "X-User-Token: ${USER_TOKEN}" \
     -H "X-User-Email: ${USER_EMAIL}" \
     -H "Content-Type: application/vnd.api+json" \
     -H "Accept: application/vnd.api+json,application/vnd.api+json; com.workdayspend.api.version=2019-01-01"
     "https://api.us.workdayspend.com/performance_review_answer_reports/entries"

Response samples

Content type
application/vnd.api+json
{
  • "data": [
    ],
  • "links": {
    }
}

Performance Review Answer Schema

Returns the performance review answer report schema.

Authorizations:
(api_keyuser_tokenuser_email)

Responses

Request samples

curl -H "X-Api-Key: ${COMPANY_KEY}" \
     -H "X-User-Token: ${USER_TOKEN}" \
     -H "X-User-Email: ${USER_EMAIL}" \
     -H "Content-Type: application/vnd.api+json" \
     -H "Accept: application/vnd.api+json,application/vnd.api+json; com.workdayspend.api.version=2019-01-01"
     "https://api.us.workdayspend.com/performance_review_answer_reports/schema"

Response samples

Content type
application/vnd.api+json
{
  • "data": {
    }
}

Performance Review Reports

This report returns a list of Performance Review report entries.

Performance Review Report Entries

Returns a list of peformance review entries.

Authorizations:
(api_keyuser_tokenuser_email)

Responses

Request samples

curl -H "X-Api-Key: ${COMPANY_KEY}" \
     -H "X-User-Token: ${USER_TOKEN}" \
     -H "X-User-Email: ${USER_EMAIL}" \
     -H "Content-Type: application/vnd.api+json" \
     -H "Accept: application/vnd.api+json,application/vnd.api+json; com.workdayspend.api.version=2019-01-01"
     "https://api.us.workdayspend.com/performance_review_reports/entries"

Response samples

Content type
application/vnd.api+json
{
  • "data": [
    ],
  • "links": {
    }
}

Performance Review Report Schema

Returns the performance review report schema.

Authorizations:
(api_keyuser_tokenuser_email)

Responses

Request samples

curl -H "X-Api-Key: ${COMPANY_KEY}" \
     -H "X-User-Token: ${USER_TOKEN}" \
     -H "X-User-Email: ${USER_EMAIL}" \
     -H "Content-Type: application/vnd.api+json" \
     -H "Accept: application/vnd.api+json,application/vnd.api+json; com.workdayspend.api.version=2019-01-01"
     "https://api.us.workdayspend.com/performance_review_reports/schema"

Response samples

Content type
application/vnd.api+json
{
  • "data": {
    }
}

Project Milestone Reports

This report returns a list of Project Milestone report entries.

Project Milestone Report Entries

Returns a list of project milestone entries.

Authorizations:
(api_keyuser_tokenuser_email)

Responses

Request samples

curl -H "X-Api-Key: ${COMPANY_KEY}" \
     -H "X-User-Token: ${USER_TOKEN}" \
     -H "X-User-Email: ${USER_EMAIL}" \
     -H "Content-Type: application/vnd.api+json" \
     -H "Accept: application/vnd.api+json,application/vnd.api+json; com.workdayspend.api.version=2019-01-01"
     "https://api.us.workdayspend.com/project_milestone_reports/entries"

Response samples

Content type
application/vnd.api+json
{
  • "data": [
    ],
  • "links": {
    }
}

Project Milestone Report Schema

Returns the project milestone report schema.

Authorizations:
(api_keyuser_tokenuser_email)

Responses

Request samples

curl -H "X-Api-Key: ${COMPANY_KEY}" \
     -H "X-User-Token: ${USER_TOKEN}" \
     -H "X-User-Email: ${USER_EMAIL}" \
     -H "Content-Type: application/vnd.api+json" \
     -H "Accept: application/vnd.api+json,application/vnd.api+json; com.workdayspend.api.version=2019-01-01"
     "https://api.us.workdayspend.com/project_milestone_reports/schema"

Response samples

Content type
application/vnd.api+json
{
  • "data": {
    }
}

Project Reports

This report returns a list of Project report entries.

Project Report Entries

Returns a list of project report entries.

Does not support project_report_id parameter for the 2019-01-01 version.

Authorizations:
(api_keyuser_tokenuser_email)

Responses

Request samples

curl -H "X-Api-Key: ${COMPANY_KEY}" \
     -H "X-User-Token: ${USER_TOKEN}" \
     -H "X-User-Email: ${USER_EMAIL}" \
     -H "Content-Type: application/vnd.api+json" \
     -H "Accept: application/vnd.api+json,application/vnd.api+json; com.workdayspend.api.version=2019-01-01"
     "https://api.us.workdayspend.com/project_reports/entries"

Response samples

Content type
application/vnd.api+json
{
  • "data": [
    ],
  • "links": {
    }
}

Project Report Schema

Returns the project report schema.

Authorizations:
(api_keyuser_tokenuser_email)

Responses

Request samples

curl -H "X-Api-Key: ${COMPANY_KEY}" \
     -H "X-User-Token: ${USER_TOKEN}" \
     -H "X-User-Email: ${USER_EMAIL}" \
     -H "Content-Type: application/vnd.api+json" \
     -H "Accept: application/vnd.api+json,application/vnd.api+json; com.workdayspend.api.version=2019-01-01"
     "https://api.us.workdayspend.com/project_reports/schema"

Response samples

Content type
application/vnd.api+json
{
  • "data": {
    }
}

Savings Reports

This report returns a list of Savings report entries.

Savings Report Entries

Returns a list of savings entries.

Authorizations:
(api_keyuser_tokenuser_email)

Responses

Request samples

curl -H "X-Api-Key: ${COMPANY_KEY}" \
     -H "X-User-Token: ${USER_TOKEN}" \
     -H "X-User-Email: ${USER_EMAIL}" \
     -H "Content-Type: application/vnd.api+json" \
     -H "Accept: application/vnd.api+json,application/vnd.api+json; com.workdayspend.api.version=2019-01-01"
     "https://api.us.workdayspend.com/savings_reports/entries"

Response samples

Content type
application/vnd.api+json
{
  • "data": [
    ],
  • "links": {
    }
}

Savings Report Schema

Returns the savings report schema.

Authorizations:
(api_keyuser_tokenuser_email)

Responses

Request samples

curl -H "X-Api-Key: ${COMPANY_KEY}" \
     -H "X-User-Token: ${USER_TOKEN}" \
     -H "X-User-Email: ${USER_EMAIL}" \
     -H "Content-Type: application/vnd.api+json" \
     -H "Accept: application/vnd.api+json,application/vnd.api+json; com.workdayspend.api.version=2019-01-01"
     "https://api.us.workdayspend.com/savings_reports/schema"

Response samples

Content type
application/vnd.api+json
{
  • "data": {
    }
}

Supplier Reports

This report returns a list of Supplier report entries.

Supplier Report Entries

Returns a list of supplier entries.

Authorizations:
(api_keyuser_tokenuser_email)

Responses

Request samples

curl -H "X-Api-Key: ${COMPANY_KEY}" \
     -H "X-User-Token: ${USER_TOKEN}" \
     -H "X-User-Email: ${USER_EMAIL}" \
     -H "Content-Type: application/vnd.api+json" \
     -H "Accept: application/vnd.api+json,application/vnd.api+json; com.workdayspend.api.version=2019-01-01"
     "https://api.us.workdayspend.com/supplier_reports/entries"

Response samples

Content type
application/vnd.api+json
{
  • "data": {
    }
}

Supplier Report Schema

Returns the supplier report schema.

Authorizations:
(api_keyuser_tokenuser_email)

Responses

Request samples

curl -H "X-Api-Key: ${COMPANY_KEY}" \
     -H "X-User-Token: ${USER_TOKEN}" \
     -H "X-User-Email: ${USER_EMAIL}" \
     -H "Content-Type: application/vnd.api+json" \
     -H "Accept: application/vnd.api+json,application/vnd.api+json; com.workdayspend.api.version=2019-01-01"
     "https://api.us.workdayspend.com/supplier_reports/schema"

Response samples

Content type
application/vnd.api+json
{
  • "data": {
    }
}

Supplier Review Reports

This report returns a list of Supplier Review report entries.

Supplier Review Report Entries

Returns a list of supplier review entries.

Authorizations:
(api_keyuser_tokenuser_email)

Responses

Request samples

curl -H "X-Api-Key: ${COMPANY_KEY}" \
     -H "X-User-Token: ${USER_TOKEN}" \
     -H "X-User-Email: ${USER_EMAIL}" \
     -H "Content-Type: application/vnd.api+json" \
     -H "Accept: application/vnd.api+json,application/vnd.api+json; com.workdayspend.api.version=2019-01-01"
     "https://api.us.workdayspend.com/supplier_review_reports/entries"

Response samples

Content type
application/vnd.api+json
{
  • "data": [
    ],
  • "links": {
    }
}

Supplier Review Report Schema

Returns the supplier review report schema.

Authorizations:
(api_keyuser_tokenuser_email)

Responses

Request samples

curl -H "X-Api-Key: ${COMPANY_KEY}" \
     -H "X-User-Token: ${USER_TOKEN}" \
     -H "X-User-Email: ${USER_EMAIL}" \
     -H "Content-Type: application/vnd.api+json" \
     -H "Accept: application/vnd.api+json,application/vnd.api+json; com.workdayspend.api.version=2019-01-01"
     "https://api.us.workdayspend.com/supplier_review_reports/schema"

Response samples

Content type
application/vnd.api+json
{
  • "data": {
    }
}

Suppliers

This report returns a list of Suppliers.

All suppliers

Returns a list of all suppliers.

Query Params

Param
include Include supplier contacts with include=contacts
sort Sort the suppliers. Supported values: name, -name, created_at, -created_at.
Authorizations:
(api_keyuser_tokenuser_email)

Responses

Request samples

curl -H "X-Api-Key: ${COMPANY_KEY}" \
     -H "X-User-Token: ${USER_TOKEN}" \
     -H "X-User-Email: ${USER_EMAIL}" \
     -H "Content-Type: application/vnd.api+json" \
     -H "Accept: application/vnd.api+json,application/vnd.api+json; com.workdayspend.api.version=2018-04-01"
     "https://api.us.workdayspend.com/suppliers"

Response samples

Content type
application/vnd.api+json
{
  • "data": [
    ],
  • "links": {
    }
}

Single supplier

Returns a single supplier.

You can optionally include the following query parameter to include supplier contacts in the response:

suppliers/1?include=contacts

Authorizations:
(api_keyuser_tokenuser_email)
path Parameters
supplier_id
required
integer
Example: 1

Unique Supplier identifier.

Responses

Request samples

curl -H "X-Api-Key: ${COMPANY_KEY}" \
     -H "X-User-Token: ${USER_TOKEN}" \
     -H "X-User-Email: ${USER_EMAIL}" \
     -H "Content-Type: application/vnd.api+json" \
     -H "Accept: application/vnd.api+json,application/vnd.api+json; com.workdayspend.api.version=2018-04-01"
     "https://api.us.workdayspend.com/suppliers/{supplier_id}"

Response samples

Content type
application/vnd.api+json
{
  • "data": {
    }
}