Workday Strategic Sourcing Events API (1.2)
Download OpenAPI specification:
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).
US Region
Environment | US region Base URI |
---|---|
Production | https://api.us.workdayspend.com/services/events/v1 |
Sandbox | https://api.sandbox.us.workdayspend.com/services/events/v1 |
EU Region
Environment | EU region Base URI |
---|---|
Production | https://api.eu.workdayspend.com/services/events/v1 |
Sandbox | https://api.sandbox.eu.workdayspend.com/services/events/v1 |
CA Region
Environment | CA region Base URI |
---|---|
Production | https://api.ca.workdayspend.com/services/events/v1 |
Sandbox | https://api.sandbox.ca.workdayspend.com/services/events/v1 |
The API conforms to the JSON API Specification.
The current version of this service is indicated by the X-Api-Version
header.
Sample version header: X-Api-Version: 1.2
.
Our API adheres to the ISO 8601 standard when accepting and formatting Date and Time fields. All Date and Time fields returned by this API will be in the UTC timezone.
Date and Time fields sent to this API can be in any timezone, provided they adhere to the ISO 8601 standard.
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 limit windows are per second and are shared by all API Keys for a company.
The rate limit is 5 requests 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.
The external_id
field exists on many of the Workday Strategic Sourcing resources. This optional and mutable extension is intended to store foreign keys of the corresponding resource from a third party system. These IDs are not considered Sourcing Data and may be logged in external systems. Do not include any sensitive or personal data in IDs.
The purpose of external IDs is to:
- Prevent duplicate record creation
- Allow resources in Workday Strategic Sourcing and a third party system to share the same identifier
- Allow for records to be queried or updated without requiring knowledge of the Workday Strategic Sourcing generated IDs
Paginated endpoints may return a subset of the total results for a GET
request that returns multiple resources. Endpoints that support pagination will include usage details in the Query Parameters section for the resource.
The paginated results can be configured using the page
query parameter to configure the number of returned results. The default pagination size is 10 results and the maximum pagination size is 100 results per request.
Endpoints that support pagination may return "self" and "next" sections within the "links" section that navigate to the current and next pages respectively.
Example Paginated Request
Request Query Parameter Format
/projects?page[size]=25
Response Schema
The paginated response will also include the following schema
object Result set metadata. | |
object (PaginationLinks) List of related links. |
null
The results can be filtered to a subset of the total set of results using filter
query parameters.
Endpoints that support filtering will include usage details in the Query Parameters section for the resource.
Most filters that end in equals
support a Query Parameter array format to filter by multiple values.
Example:
?filter[status_equals][]=submitted&filter[status_equals][]=resubmitted
type required | string (EventType) Object type, should always be |
id required | integer (EventId) Event identifier string. |
object (EventAttributes) Event attributes. | |
object (EventRelationship) Event relationships. | |
object (ResourceLinks) List of related links. |
{- "id": "1",
- "type": "events",
- "attributes": {
- "title": "Event Title",
- "spend_amount": 500,
- "supplier_rsvp_deadline": "2020-03-30T19:00:00.000Z",
- "supplier_question_deadline": "2020-04-30T19:00:00.000Z",
- "bid_submission_deadline": "2020-05-30T19:00:00.000Z",
- "event_type": "RFP",
- "state": "closed",
- "duplication_state": "finished",
- "request_type": "RFP",
- "late_bids": true,
- "revise_bids": false,
- "instant_notifications": false,
- "created_at": "2020-03-16T02:36:31.276Z",
- "updated_at": "2020-03-17T02:36:31.276Z",
- "published_at": "2020-03-17T02:36:31.276Z",
- "closed_at": "2020-03-16T02:36:31.276Z",
- "external_id": "EVENT1",
- "is_public": false,
- "restricted": true,
- "custom_fields": [
- {
- "name": "Field #0",
- "value": "Field value"
}
]
}, - "relationships": {
- "attachments": {
- "data": [
- {
- "id": "1",
- "type": "attachments"
}, - {
- "id": "2",
- "type": "attachments"
}
]
}, - "event_template": {
- "data": {
- "id": "1",
- "type": "event_templates"
}
}, - "spend_category": {
- "data": {
- "id": "1",
- "type": "spend_categories"
}
}, - "project": {
- "data": {
- "id": "1",
- "type": "projects"
}
}, - "commodity_codes": {
- "data": [
- {
- "id": "1",
- "type": "commodity_codes"
}, - {
- "id": "2",
- "type": "commodity_codes"
}
]
}
},
}
List Events
Returns a list of events for the specified criteria.
Authorizations:
query Parameters
object (EventInputFilter) Filter events by multiple criteria. Only one filter per attribute is supported. For best performance, we recommend 5 or less filters. | |
object (PageInput) Customize pagination results with |
Responses
Request samples
- Curl
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" \ "https://api.us.workdayspend.com/services/events/v1/events"
Response samples
- 200
{- "meta": {
- "count": 2
}, - "data": [
- {
- "id": "1",
- "type": "events",
- "attributes": {
- "title": "Event #1",
- "spend_amount": 500.5,
- "supplier_rsvp_deadline": "2020-03-30T19:00:00.000Z",
- "supplier_question_deadline": "2020-04-30T19:00:00.000Z",
- "bid_submission_deadline": "2020-05-30T19:00:00.000Z",
- "event_type": "RFP",
- "state": "draft",
- "duplication_state": null,
- "request_type": "RFP",
- "late_bids": true,
- "revise_bids": false,
- "instant_notifications": false,
- "custom_fields": [
- {
- "name": "Field #0",
- "value": null
}
], - "created_at": "2020-03-16T02:36:31.276Z",
- "updated_at": "2020-03-17T02:36:31.276Z",
- "published_at": "2020-03-17T02:36:31.276Z",
- "closed_at": null,
- "external_id": "EVENT1",
- "is_public": false,
- "restricted": true
}, - "relationships": {
- "attachments": {
- "data": [ ]
}, - "event_template": {
- "data": null
}, - "spend_category": {
- "data": {
- "id": "1",
- "type": "spend_categories"
}
}, - "project": {
- "data": null
}, - "commodity_codes": {
- "data": [ ]
}
},
}, - {
- "id": "2",
- "type": "events",
- "attributes": {
- "title": "Event #2",
- "spend_amount": 231.5,
- "supplier_rsvp_deadline": null,
- "supplier_question_deadline": null,
- "bid_submission_deadline": null,
- "event_type": "RFP",
- "state": "draft",
- "duplication_state": null,
- "request_type": "RFP",
- "late_bids": true,
- "revise_bids": true,
- "instant_notifications": false,
- "custom_fields": [
- {
- "name": "Field #0",
- "value": "Field value"
}
], - "updated_at": "2020-03-17T03:01:45.616Z",
- "closed_at": null,
- "external_id": "EVENT2",
- "is_public": false,
- "restricted": true
}, - "relationships": {
- "attachments": {
- "data": [
- {
- "id": "1",
- "type": "attachments"
}, - {
- "id": "2",
- "type": "attachments"
}
]
}, - "event_template": {
- "data": {
- "id": "1",
- "type": "event_templates"
}
}, - "spend_category": {
- "data": {
- "id": "1",
- "type": "spend_categories"
}
}, - "project": {
- "data": {
- "id": "1",
- "type": "projects"
}
}, - "commodity_codes": {
- "data": [
- {
- "id": "1",
- "type": "commodity_codes"
}, - {
- "id": "2",
- "type": "commodity_codes"
}
]
}
},
}
], - "links": {
}
}
Create an Event
Events can only be created from a template. When a creation request is issued, the base event
object will be created from the template and returned with the response. Child records
such as attachments, price sheets and custom values, will be scheduled for copy asynchronously.
Current duplication status can be retrieved from the duplication_state
attribute, which will have
one of following values:
scheduled
- duplication is scheduled, but not yet started;started
- duplication started, but not yet finished;finished
- duplication completed;failed
- there was an error duplicating relationships.
An event should always have an associated project. Please make sure to specify it as a relationship object.
A new event will automatically inherit its spend category from the event template.
Please note, this endpoint does not support auction creation/duplication.
Authorizations:
Request Body schema: application/vnd.api+json
object (EventCreate) |
Responses
Request samples
- Payload
- Curl
{- "data": {
- "type": "events",
- "attributes": {
- "duplicate_bids": true,
- "is_public": false,
- "external_id": "EVENT1"
}, - "relationships": {
- "event_template": {
- "data": {
- "id": "1",
- "type": "event_templates"
}
}, - "project": {
- "data": {
- "id": "1",
- "type": "projects"
}
}
}
}
}
Response samples
- 201
- 422
{- "data": {
- "id": "2",
- "type": "events",
- "attributes": {
- "title": "Copy of Event Title",
- "spend_amount": 500.5,
- "supplier_rsvp_deadline": "2020-03-30T19:00:00.000Z",
- "supplier_question_deadline": "2020-04-30T19:00:00.000Z",
- "bid_submission_deadline": "2020-05-30T19:00:00.000Z",
- "event_type": "RFP",
- "state": "draft",
- "request_type": "RFP",
- "late_bids": true,
- "revise_bids": true,
- "instant_notifications": true,
- "custom_fields": [ ],
- "created_at": "2020-03-16T02:36:31.276Z",
- "updated_at": "2020-03-17T02:36:31.276Z",
- "published_at": "2020-03-17T02:36:31.276Z",
- "closed_at": null,
- "duplication_state": "scheduled",
- "external_id": "EVENT1",
- "is_public": false,
- "restricted": true
}, - "relationships": {
- "attachments": {
- "data": [ ]
}, - "event_template": {
- "data": {
- "id": "1",
- "type": "event_templates"
}
}, - "project": {
- "data": {
- "id": "1",
- "type": "projects"
}
}, - "spend_category": {
- "data": {
- "id": "1",
- "type": "spend_categories"
}
}, - "commodity_codes": {
- "data": [ ]
}
},
}
}
Get an Event
Retrieves the details of an existing event. You need to supply the unique event identifier that was returned upon event creation.
Authorizations:
path Parameters
id required | integer Example: 1 Unique Event identifier. |
Responses
Request samples
- Curl
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" \ "https://api.us.workdayspend.com/services/events/v1/events/1"
Response samples
- 200
{- "data": {
- "id": "1",
- "type": "events",
- "attributes": {
- "title": "Event Title",
- "spend_amount": 500.5,
- "supplier_rsvp_deadline": "2020-03-30T19:00:00.000Z",
- "supplier_question_deadline": "2020-04-30T19:00:00.000Z",
- "bid_submission_deadline": "2020-05-30T19:00:00.000Z",
- "event_type": "RFP",
- "state": "draft",
- "duplication_state": "finished",
- "request_type": "RFP",
- "late_bids": true,
- "revise_bids": false,
- "instant_notifications": false,
- "custom_fields": [
- {
- "name": "Field #1",
- "value": "Field value"
}
], - "created_at": "2020-03-16T02:36:31.276Z",
- "updated_at": "2020-03-17T02:36:31.276Z",
- "published_at": "2020-03-17T02:36:31.276Z",
- "closed_at": null,
- "external_id": "EVENT1",
- "is_public": false,
- "restricted": true
}, - "relationships": {
- "attachments": {
- "data": [
- {
- "id": "1",
- "type": "attachments"
}, - {
- "id": "2",
- "type": "attachments"
}
]
}, - "event_template": {
- "data": {
- "id": "1",
- "type": "event_templates"
}
}, - "spend_category": {
- "data": {
- "id": "1",
- "type": "spend_categories"
}
}, - "project": {
- "data": {
- "id": "1",
- "type": "projects"
}
}, - "commodity_codes": {
- "data": [
- {
- "id": "1",
- "type": "commodity_codes"
}, - {
- "id": "2",
- "type": "commodity_codes"
}
]
}
},
}
}
Update an Event
Updates the details of an existing event. You need to supply the unique identifier that was returned upon event creation.
Please note, that request body must include an id
attribute with the value of your event
unique identifier (the same one you passed in the URL).
Authorizations:
path Parameters
id required | integer Example: 1 Unique Event identifier. |
Request Body schema: application/vnd.api+json
object (EventUpdate) |
Responses
Request samples
- Payload
- Curl
{- "data": {
- "type": "events",
- "id": "2",
- "attributes": {
- "title": "Event Title Updated",
- "spend_amount": 244.44,
- "late_bids": true,
- "revise_bids": false,
- "instant_notifications": false,
- "supplier_rsvp_deadline": "2031-12-30T00:00:00.000Z",
- "supplier_question_deadline": "2032-12-30T00:00:00.000Z",
- "bid_submission_deadline": "2033-12-30T00:00:00.000Z",
- "external_id": "UEVENT1",
- "custom_fields": [
- {
- "name": "Custom field name",
- "value": "Updated custom field value"
}
]
}, - "relationships": {
- "project": {
- "data": {
- "id": "3",
- "type": "projects"
}
}, - "spend_category": {
- "data": {
- "id": "4",
- "type": "spend_categories"
}
}, - "department": {
- "data": {
- "id": "5",
- "type": "departments"
}
}
}
}
}
Response samples
- 200
- 409
{- "data": {
- "type": "events",
- "id": "2",
- "attributes": {
- "title": "Event Title Updated",
- "spend_amount": 244.44,
- "event_type": "RFP",
- "request_type": "RFP",
- "state": "draft",
- "duplication_state": null,
- "late_bids": true,
- "revise_bids": false,
- "instant_notifications": false,
- "custom_fields": [
- {
- "name": "Custom field name",
- "value": "Updated custom field value"
}
], - "supplier_rsvp_deadline": "2031-12-30T00:00:00.000Z",
- "supplier_question_deadline": "2032-12-30T00:00:00.000Z",
- "bid_submission_deadline": "2033-12-30T00:00:00.000Z",
- "closed_at": null,
- "external_id": "UEVENT1",
- "is_public": false,
- "restricted": true
}, - "relationships": {
- "attachments": {
- "data": [ ]
}, - "event_template": {
- "data": {
- "id": "1",
- "type": "event_templates"
}
}, - "spend_category": {
- "data": {
- "id": "4",
- "type": "spend_categories"
}
}, - "project": {
- "data": {
- "id": "3",
- "type": "projects"
}
}, - "commodity_codes": {
- "data": [ ]
}
},
}
}
Delete an Event
Deletes an event. You need to supply the unique event identifier that was returned upon event creation.
Authorizations:
path Parameters
id required | integer Example: 1 Unique Event identifier. |
Responses
Request samples
- Curl
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" \ -X DELETE \ "https://api.us.workdayspend.com/services/events/v1/events/1"
Describe Event Object
Returns the list of fields for the event object.
Authorizations:
Responses
Request samples
- Curl
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" \ "https://api.us.workdayspend.com/services/events/v1/events/describe"
Response samples
- 200
{- "data": [
- {
- "id": "title",
- "type": "event_fields",
- "attributes": {
- "name": "title",
- "data_type": "string",
- "type_description": "Short Text",
- "custom_field": false
}
}, - {
- "id": "external_id",
- "type": "event_fields",
- "attributes": {
- "name": "external_id",
- "data_type": "string",
- "type_description": "Short Text",
- "custom_field": false
}
}, - {
- "id": "state",
- "type": "event_fields",
- "attributes": {
- "name": "state",
- "data_type": "string",
- "type_description": "Single Select",
- "custom_field": false
}
}, - {
- "id": "spend_amount",
- "type": "event_fields",
- "attributes": {
- "name": "spend_amount",
- "data_type": "number",
- "type_description": "Currency",
- "custom_field": false
}
}, - {
- "id": "request_type",
- "type": "event_fields",
- "attributes": {
- "name": "request_type",
- "data_type": "string",
- "type_description": "Single Select",
- "custom_field": false
}
}, - {
- "id": "late_bids",
- "type": "event_fields",
- "attributes": {
- "name": "late_bids",
- "data_type": "boolean",
- "type_description": "Checkbox",
- "custom_field": false
}
}, - {
- "id": "revise_bids",
- "type": "event_fields",
- "attributes": {
- "name": "revise_bids",
- "data_type": "boolean",
- "type_description": "Checkbox",
- "custom_field": false
}
}, - {
- "id": "department",
- "type": "event_fields",
- "attributes": {
- "name": "department",
- "data_type": "string",
- "type_description": "Short Text",
- "custom_field": false
}
}, - {
- "id": "instant_notifications",
- "type": "event_fields",
- "attributes": {
- "name": "instant_notifications",
- "data_type": "boolean",
- "type_description": "Checkbox",
- "custom_field": false
}
}, - {
- "id": "supplier_rsvp_deadline",
- "type": "event_fields",
- "attributes": {
- "name": "supplier_rsvp_deadline",
- "data_type": "string",
- "type_description": "Date",
- "custom_field": false
}
}, - {
- "id": "supplier_question_deadline",
- "type": "event_fields",
- "attributes": {
- "name": "supplier_question_deadline",
- "data_type": "string",
- "type_description": "Date",
- "custom_field": false
}
}, - {
- "id": "bid_submission_deadline",
- "type": "event_fields",
- "attributes": {
- "name": "bid_submission_deadline",
- "data_type": "string",
- "type_description": "Date",
- "custom_field": false
}
}, - {
- "id": "created_at",
- "type": "event_fields",
- "attributes": {
- "name": "created_at",
- "data_type": "string",
- "type_description": "Date",
- "custom_field": false
}
}, - {
- "id": "updated_at",
- "type": "event_fields",
- "attributes": {
- "name": "updated_at",
- "data_type": "string",
- "type_description": "Date",
- "custom_field": false
}
}, - {
- "id": "published_at",
- "type": "event_fields",
- "attributes": {
- "name": "published_at",
- "data_type": "string",
- "type_description": "Date",
- "custom_field": false
}
}, - {
- "id": "closed_at",
- "type": "event_fields",
- "attributes": {
- "name": "closed_at",
- "data_type": "string",
- "type_description": "Date",
- "custom_field": false
}
}, - {
- "id": "is_public",
- "type": "event_fields",
- "attributes": {
- "name": "is_public",
- "data_type": "boolean",
- "type_description": "Checkbox",
- "custom_field": false
}
}, - {
- "id": "restricted",
- "type": "event_fields",
- "attributes": {
- "name": "restricted",
- "data_type": "boolean",
- "type_description": "Checkbox",
- "custom_field": false
}
}, - {
- "id": "custom_field_1",
- "type": "event_fields",
- "attributes": {
- "name": "Custom field #1",
- "data_type": "string",
- "type_description": "Short Text",
- "custom_field": true
}
}
], - "links": { },
- "meta": {
- "count": 19
}
}
Add Suppliers
Add suppliers to an event. Only events of type RFP
are supported.
The operation will be rolled back upon any failure, and invitations won't be sent.
For best performance, we recommend inviting 10 or less suppliers in a single request.
Authorizations:
path Parameters
event_id required | integer Example: 1 Event identifier. |
Request Body schema: application/vnd.api+json
Array of objects (SupplierCompany) |
Responses
Request samples
- Payload
- Curl
{- "data": [
- {
- "type": "supplier_companies",
- "id": "5"
}, - {
- "type": "supplier_companies",
- "id": "11"
}
]
}
Remove Suppliers
Remove suppliers from an event. Only events of type RFP
are supported.
The operation will be rolled back upon any failure, and invitations won't be removed.
For best performance, we recommend removing 10 or less suppliers in a single request.
Authorizations:
path Parameters
event_id required | integer Example: 1 Event identifier. |
Request Body schema: application/vnd.api+json
object (SupplierCompany) |
Responses
Request samples
- Payload
- Curl
{- "data": [
- {
- "type": "supplier_companies",
- "id": "5"
}, - {
- "type": "supplier_companies",
- "id": "11"
}
]
}
Add Suppliers using External IDs
Add suppliers to an event. Only events of type RFP
are supported.
You must supply the unique event external identifier (the one you used when created the event).
You must supply the external identifiers of the supplier companies too.
The operation will be rolled back upon any failure, and invitations won't be sent.
For best performance, we recommend inviting 10 or less suppliers in a single request.
Authorizations:
path Parameters
event_external_id required | string Example: EVENT1 Event external identifier. |
Request Body schema: application/vnd.api+json
Array of objects (ExternalSupplierCompany) |
Responses
Request samples
- Payload
- Curl
{- "data": [
- {
- "type": "supplier_companies",
- "id": "SUP5"
}, - {
- "type": "supplier_companies",
- "id": "SUP11"
}
]
}
Remove Suppliers using External IDs
Remove suppliers from an event. Only events of type RFP
are supported.
You must supply the unique event external identifier (the one you used when created the event).
You must supply the external identifiers of the supplier companies too.
The operation will be rolled back upon any failure, and invitations won't be removed.
For best performance, we recommend removing 10 or less suppliers in a single request.
Authorizations:
path Parameters
event_external_id required | string Example: EVENT1 Event external identifier. |
Request Body schema: application/vnd.api+json
Array of objects (ExternalSupplierCompany) |
Responses
Request samples
- Payload
- Curl
{- "data": [
- {
- "type": "supplier_companies",
- "id": "SUP5"
}, - {
- "type": "supplier_companies",
- "id": "SUP11"
}
]
}
Use the event supplier contacts API to manage event suppliers. This API provides 2 advantages over the event supplier companies APIs:
- It allows specifying the supplier contact to be associated/removed from an event.
- It allows specifying multiple contacts for a given supplier.
Add Suppliers using Contacts
Add suppliers to an event using supplier contacts. Only events of type RFP
are supported.
For best performance, we recommend inviting 10 or less supplier contacts in a single request.
Authorizations:
path Parameters
event_id required | integer Example: 1 Event identifier. |
Request Body schema: application/vnd.api+json
Array of objects (SupplierContact) |
Responses
Request samples
- Payload
- Curl
{- "data": [
- {
- "type": "supplier_contacts",
- "id": "10"
}, - {
- "type": "supplier_contacts",
- "id": "17"
}
]
}
Remove Suppliers using Contacts
Remove suppliers from an event using supplier contacts. Only events of type RFP
are supported.
For best performance, we recommend removing 10 or less supplier contacts in a single request.
Authorizations:
path Parameters
event_id required | integer Example: 1 Event identifier. |
Request Body schema: application/vnd.api+json
Array of objects (SupplierContact) |
Responses
Request samples
- Payload
- Curl
{- "data": [
- {
- "type": "supplier_contacts",
- "id": "10"
}, - {
- "type": "supplier_contacts",
- "id": "17"
}
]
}
Add Suppliers using Contacts External IDs
Add suppliers to an event using supplier contacts. Only events of type RFP
are supported.
You must supply the unique event external identifier (the one you used when created the event).
You must supply the external identifiers of the supplier contacts too.
The operation will be rolled back upon any failure, and invitations won't be sent.
For best performance, we recommend inviting 10 or less supplier contacts in a single request.
Authorizations:
path Parameters
event_external_id required | string Example: EVENT1 Event external identifier. |
Request Body schema: application/vnd.api+json
Array of objects (ExternalSupplierContact) |
Responses
Request samples
- Payload
- Curl
{- "data": [
- {
- "type": "supplier_contacts",
- "id": "SUPC10"
}, - {
- "type": "supplier_contacts",
- "id": "SUPC17"
}
]
}
Remove Suppliers using Contacts External IDs
Remove suppliers from an event using supplier contacts. Only events of type RFP
are supported.
You must supply the unique event external identifier (the one you used when created the event).
You must supply the external identifiers of the supplier contacts too.
The operation will be rolled back upon any failure, and invitations won't be removed.
For best performance, we recommend removing 10 or less supplier contacts in a single request.
Authorizations:
path Parameters
event_external_id required | integer Example: 1 Event external identifier. |
Request Body schema: application/vnd.api+json
Array of objects (ExternalSupplierContact) |
Responses
Request samples
- Payload
- Curl
{- "data": [
- {
- "type": "supplier_contacts",
- "id": "SUPC10"
}, - {
- "type": "supplier_contacts",
- "id": "SUPC17"
}
]
}
Use the contract types API to query the event templates in Workday Strategic Sourcing.
Event Templates are used as a blueprint for newly created events.
type required | string (EventTemplateType) Object type, should always be |
id required | integer (EventTemplateId) Event template identifier string. |
object (EventTemplateAttributes) Event template attributes. | |
object (ResourceLinks) List of related links. |
{- "type": "event_templates",
- "id": 1,
- "attributes": {
- "title": "My Event Template",
- "event_type": "RFP"
}, - "links": {
- "self": "string"
}
}
List Event Templates
Returns a list of all event templates.
Authorizations:
Responses
Request samples
- Curl
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" \ "https://api.us.workdayspend.com/services/events/v1/event_templates"
Response samples
- 200
{- "meta": {
- "count": 2
}, - "data": [
- {
- "type": "event_templates",
- "id": "1",
- "attributes": {
- "title": "Event Template #1",
- "event_type": "RFP"
},
}, - {
- "type": "event_templates",
- "id": "2",
- "attributes": {
- "title": "Event Template #2",
- "event_type": "PERFORMANCE_REVIEW_EVENT"
},
}
],
}
Get an Event Template
Retrieves the details of an existing event template.
Authorizations:
path Parameters
id required | integer Example: 1 Unique event template identifier. |
Responses
Request samples
- Curl
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" \ "https://api.us.workdayspend.com/services/events/v1/event_templates/1"
Response samples
- 200
{- "data": {
- "type": "event_templates",
- "id": "1",
- "attributes": {
- "title": "The Event Template",
- "event_type": "RFP"
},
}
}
Use the worksheets API to create, update, and query the worksheets in Workday Strategic Sourcing.
type required | string (WorksheetType) Object type, should always be |
id required | integer (WorksheetId) Worksheet identifier string. |
object (WorksheetAttributes) Worksheet attributes. | |
object (ResourceLinks) List of related links. |
{- "type": "worksheets",
- "id": 1,
- "attributes": {
- "title": "string",
- "budget": 11.11,
- "notes": "string",
- "updated_at": "2019-10-29T21:28:46.790Z",
- "worksheet_type": "standard",
- "columns": [
- {
- "id": 1,
- "name": "My Worksheet Column Field",
- "data_identifier": "c1234",
- "mapping_key": "TITLE"
}
]
}, - "links": {
- "self": "string"
}
}
List Worksheets
Returns a list of all worksheets.
Authorizations:
path Parameters
event_id required | integer Example: 1 Event identifier. |
Responses
Request samples
- Curl
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" \ "https://api.us.workdayspend.com/services/events/v1/events/1/worksheets"
Response samples
- 200
{- "meta": {
- "count": 2
}, - "data": [
- {
- "type": "worksheets",
- "id": "1",
- "attributes": {
- "title": "Worksheet title #1",
- "budget": 120.32,
- "notes": "Worksheet related notes",
- "updated_at": "2019-10-29T21:28:46.790Z",
- "worksheet_type": "standard",
- "columns": [
- {
- "id": "141",
- "name": "Title",
- "data_identifier": "c1",
- "mapping_key": "TITLE"
}, - {
- "id": "143",
- "name": "Unit of Measure",
- "data_identifier": "c3",
- "mapping_key": "UNIT_OF_MEASURE"
}, - {
- "id": "142",
- "name": "Quantity",
- "data_identifier": "c2",
- "mapping_key": "QUANTITY"
}, - {
- "id": "145",
- "name": "Price",
- "data_identifier": "c5",
- "mapping_key": "PRICE"
}, - {
- "id": "144",
- "name": "Extended Price",
- "data_identifier": "c4",
- "mapping_key": "EXTENDED_PRICE"
}
]
},
}, - {
- "type": "worksheets",
- "id": "2",
- "attributes": {
- "title": "Worksheet title #2",
- "budget": null,
- "notes": null,
- "updated_at": "2019-10-29T21:28:46.790Z",
- "worksheet_type": "standard",
- "columns": [
- {
- "id": "146",
- "name": "Title",
- "data_identifier": "c6",
- "mapping_key": "TITLE"
}, - {
- "id": "148",
- "name": "Unit of Measure",
- "data_identifier": "c8",
- "mapping_key": "UNIT_OF_MEASURE"
}, - {
- "id": "147",
- "name": "Quantity",
- "data_identifier": "c7",
- "mapping_key": "QUANTITY"
}, - {
- "id": "150",
- "name": "Price",
- "data_identifier": "c10",
- "mapping_key": "PRICE"
}, - {
- "id": "149",
- "name": "Extended Price",
- "data_identifier": "c9",
- "mapping_key": "EXTENDED_PRICE"
}
]
},
}
],
}
Get a Worksheet
Retrieves the details of an existing worksheet. You need to supply the unique worksheet identifier that was returned upon worksheet creation.
Authorizations:
path Parameters
event_id required | integer Example: 1 Event identifier. |
id required | integer Example: 1 Unique Worksheet identifier. |
Responses
Request samples
- Curl
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" \ "https://api.us.workdayspend.com/services/events/v1/events/1/worksheets/1"
Response samples
- 200
{- "data": {
- "type": "worksheets",
- "id": "1",
- "attributes": {
- "title": "Worksheet title #1",
- "budget": null,
- "notes": null,
- "updated_at": "2019-10-29T21:28:46.790Z",
- "worksheet_type": "standard",
- "columns": [
- {
- "id": "111",
- "name": "Title",
- "data_identifier": "c11",
- "mapping_key": "TITLE"
}, - {
- "id": "113",
- "name": "Unit of Measure",
- "data_identifier": "c13",
- "mapping_key": "UNIT_OF_MEASURE"
}, - {
- "id": "112",
- "name": "Quantity",
- "data_identifier": "c12",
- "mapping_key": "QUANTITY"
}, - {
- "id": "115",
- "name": "Price",
- "data_identifier": "c15",
- "mapping_key": "PRICE"
}, - {
- "id": "114",
- "name": "Extended Price",
- "data_identifier": "c14",
- "mapping_key": "EXTENDED_PRICE"
}
]
},
}
}
Describe Worksheet object
Returns a list of fields for the worksheet object.
Authorizations:
Responses
Request samples
- Curl
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" \ "https://api.us.workdayspend.com/services/events/v1/worksheets/describe"
Response samples
- 200
{- "meta": {
- "count": 4
}, - "data": [
- {
- "id": "title",
- "type": "worksheet_fields",
- "attributes": {
- "name": "title",
- "data_type": "string",
- "type_description": "Short Text",
- "custom_field": false
}
}, - {
- "id": "budget",
- "type": "worksheet_fields",
- "attributes": {
- "name": "budget",
- "data_type": "number",
- "type_description": "Decimal",
- "custom_field": false
}
}, - {
- "id": "notes",
- "type": "worksheet_fields",
- "attributes": {
- "name": "notes",
- "data_type": "string",
- "type_description": "Paragraph",
- "custom_field": false
}
}, - {
- "id": "updated_at",
- "type": "worksheet_fields",
- "attributes": {
- "name": "updated_at",
- "data_type": "string",
- "type_description": "Date",
- "custom_field": false
}
}
], - "links": { }
}
Use the line items API to create, update, and query the worksheet line items in Workday Strategic Sourcing.
type required | string (LineItemType) Object type, should always be |
id required | integer (LineItemId) LineItem identifier string. |
object (LineItemAttributes) LineItem attributes. |
{- "type": "line_items",
- "id": 1,
- "attributes": {
- "data": {
- "data_identifier": "string",
- "value1": null,
- "value2": null
}
}
}
List Line Items
Returns a list of line items for the specified criteria.
Authorizations:
path Parameters
event_id required | integer Example: 1 Event identifier. |
worksheet_id required | integer Example: 1 Worksheet identifier. |
Responses
Request samples
- Curl
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" \ "https://api.us.workdayspend.com/services/events/v1/events/1/worksheets/1/line_items"
Response samples
- 200
{- "data": [
- {
- "id": "1",
- "type": "line_items",
- "attributes": {
- "data": {
- "c1": "Product One",
- "c2": 11,
- "c3": "items"
}
}
}, - {
- "id": "2",
- "type": "line_items",
- "attributes": {
- "data": {
- "c1": "Product Two",
- "c2": 1,
- "c3": "items"
}
}
}
], - "links": {
}
}
Create a Line Item
Create a line item with given cell values.
Authorizations:
path Parameters
event_id required | integer Example: 1 Event identifier. |
worksheet_id required | integer Example: 1 Worksheet identifier. |
Request Body schema: application/vnd.api+json
object (LineItemCreate) |
Responses
Request samples
- Payload
- Curl
{- "data": {
- "type": "line_items",
- "attributes": {
- "data": {
- "c1": "Amazing Product",
- "c2": "items",
- "c3": 14
}
}, - "relationships": {
- "worksheet": {
- "data": {
- "type": "worksheets",
- "id": "1"
}
}
}
}
}
Response samples
- 201
{- "data": {
- "id": "1",
- "type": "line_items",
- "attributes": {
- "data": {
- "c1": "Amazing Product",
- "c2": "items",
- "c3": 14,
- "c4": 0
}
}
}
}
Bulk Create Line Items
Create multiple line items in a given worksheet. You can create up to 200 line items in a single request.
Authorizations:
path Parameters
event_id required | integer Example: 1 Event identifier. |
worksheet_id required | integer Example: 1 Worksheet identifier. |
Request Body schema: application/vnd.api+json
Array of objects |
Responses
Request samples
- Payload
- Curl
{- "data": [
- {
- "type": "line_items",
- "attributes": {
- "data": {
- "c1": "Product One",
- "c2": "items",
- "c3": 14
}
}
}, - {
- "type": "line_items",
- "attributes": {
- "data": {
- "c1": "Product Two",
- "c2": "items",
- "c3": 1
}
}
}
]
}
Response samples
- 201
{- "data": [
- {
- "id": "1",
- "type": "line_items",
- "attributes": {
- "data": {
- "c1": "Product One",
- "c2": "items",
- "c3": 14,
- "c4": 0
}
}
}, - {
- "id": "2",
- "type": "line_items",
- "attributes": {
- "data": {
- "c1": "Product Two",
- "c2": "items",
- "c3": 1,
- "c4": 0
}
}
}
]
}
Get a Line Item
Retrieves the details of an existing line item. You need to supply the unique line item identifier that was returned upon line item creation.
Authorizations:
path Parameters
event_id required | integer Example: 1 Event identifier. |
worksheet_id required | integer Example: 1 Worksheet identifier. |
id required | integer Example: 1 Unique line item identifier. |
Responses
Request samples
- Curl
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" \ "https://api.us.workdayspend.com/services/events/v1/events/1/worksheets/1/line_items/1"
Response samples
- 200
{- "data": {
- "id": "1",
- "type": "line_items",
- "attributes": {
- "data": {
- "c1": "Amazing Product",
- "c2": 10,
- "c3": "items"
}
}
}
}
Update a Line Item
Updates the details of an existing line item. You need to supply the unique line item that was returned upon line item creation.
Please note, that request body must include the id
attribute with the value of your
line item unique identifier (the same one you passed in the URL).
Authorizations:
path Parameters
event_id required | integer Example: 1 Event identifier. |
worksheet_id required | integer Example: 1 Worksheet identifier. |
id required | integer Example: 1 Unique line item identifier. |
Request Body schema: application/vnd.api+json
object (LineItemUpdate) |
Responses
Request samples
- Payload
- Curl
{- "data": {
- "id": "1",
- "type": "line_items",
- "attributes": {
- "data": {
- "c1": "Painfully Amazing Product",
- "c2": 24,
- "c3": "items"
}
}, - "relationships": {
- "worksheet": {
- "data": {
- "type": "worksheets",
- "id": "1"
}
}
}
}
}
Response samples
- 200
- 409
{- "data": {
- "id": "1",
- "type": "line_items",
- "attributes": {
- "data": {
- "c1": "Painfully Amazing Product",
- "c2": 24,
- "c3": "items",
- "c4": 0
}
}
}
}
Delete a Line Item
Deletes a line item. You need to supply the unique line item identifier that was returned upon line item creation.
Authorizations:
path Parameters
event_id required | integer Example: 1 Event identifier. |
worksheet_id required | integer Example: 1 Worksheet identifier. |
id required | integer Example: 1 Unique line item identifier. |
Responses
Request samples
- Curl
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" \ -X DELETE \ "https://api.us.workdayspend.com/services/events/v1/events/1/worksheets/1/line_items/1"
Use the bids API to query the bids in Workday Strategic Sourcing.
Only bids for events of type RFP
are supported.
type required | string (BidType) Object type, should always be |
id required | integer (BidId) Bid identifier string. |
object (BidAttributes) Bid attributes. | |
object (BidRelationship) Bid relationships. | |
object (ResourceLinks) List of related links. |
{- "id": "1",
- "type": "bids",
- "attributes": {
- "intend_to_bid": true,
- "intend_to_bid_answered_at": "2020-01-02T03:04:05.000Z",
- "status": "resubmitted",
- "submitted_at": "2020-01-02T03:04:05.000Z",
- "resubmitted_at": "2020-01-02T03:04:05.000Z"
}, - "relationships": {
- "event": {
- "data": {
- "id": "1",
- "type": "events"
}
}, - "supplier_company": {
- "data": {
- "id": "1",
- "type": "supplier_companies"
}
}
},
}
List Bids
Returns a list of all bids.
Only bids for events of type RFP
are returned.
Authorizations:
path Parameters
event_id required | integer Example: 1 Event identifier. |
query Parameters
object (BidInputFilter) Filter bids by multiple criteria. Only one filter per attribute is supported. For best performance, we recommend 5 or less filters. | |
include | string (BidRelatedResources) Enum: "event" "supplier_company" Use the |
object (PageInput) Customize pagination results with |
Responses
Request samples
- Curl
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" \ "https://api.us.workdayspend.com/services/events/v1/events/1/bids"
Response samples
- 200
{- "meta": {
- "count": 2
}, - "data": [
- {
- "id": "1",
- "type": "bids",
- "attributes": {
- "intend_to_bid": true,
- "intend_to_bid_answered_at": "2020-01-02T03:04:05.000Z",
- "status": "resubmitted",
- "submitted_at": "2020-01-02T03:04:05.000Z",
- "resubmitted_at": "2020-01-02T03:04:05.000Z"
}, - "relationships": {
- "event": {
- "data": {
- "id": "1",
- "type": "events"
}
}, - "supplier_company": {
- "data": {
- "id": "1",
- "type": "supplier_companies"
}
}
},
}, - {
- "id": "2",
- "type": "bids",
- "attributes": {
- "intend_to_bid": false,
- "intend_to_bid_answered_at": "2020-01-02T03:04:05.000Z",
- "status": "awarded",
- "submitted_at": "2020-01-02T03:04:05.000Z",
- "resubmitted_at": "2020-01-02T03:04:05.000Z"
}, - "relationships": {
- "event": {
- "data": {
- "id": "1",
- "type": "events"
}
}, - "supplier_company": {
- "data": {
- "id": "1",
- "type": "supplier_companies"
}
}
},
}
], - "links": {
}
}
Get a Bid
Retrieves the details of an existing bid. You need to supply the unique bid identifier that was returned upon bid creation.
Authorizations:
path Parameters
id required | integer Example: 1 Unique Bid identifier. |
query Parameters
include | string (BidRelatedResources) Enum: "event" "supplier_company" Use the |
Responses
Request samples
- Curl
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" \ "https://api.us.workdayspend.com/services/events/v1/bids/1"
Response samples
- 200
{- "data": {
- "type": "bids",
- "id": "1",
- "attributes": {
- "intend_to_bid": true,
- "intend_to_bid_answered_at": "2020-01-02T03:04:05.000Z",
- "status": "resubmitted",
- "submitted_at": "2020-01-02T03:04:05.000Z",
- "resubmitted_at": "2020-01-02T03:04:05.000Z"
}, - "relationships": {
- "event": {
- "data": {
- "id": "1",
- "type": "events"
}
}, - "supplier_company": {
- "data": {
- "id": "1",
- "type": "supplier_companies"
}
}
},
}
}
Describe Bid object
Returns a list of fields for the bid object.
Authorizations:
Responses
Request samples
- Curl
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" \ "https://api.us.workdayspend.com/services/events/v1/bids/describe"
Response samples
- 200
{- "meta": {
- "count": 7
}, - "data": [
- {
- "id": "intend_to_bid",
- "type": "bid_fields",
- "attributes": {
- "name": "intend_to_bid",
- "data_type": "boolean",
- "type_description": "Checkbox",
- "custom_field": false
}
}, - {
- "id": "intend_to_bid_answered_at",
- "type": "bid_fields",
- "attributes": {
- "name": "intend_to_bid_answered_at",
- "data_type": "string",
- "type_description": "Date",
- "custom_field": false
}
}, - {
- "id": "status",
- "type": "bid_fields",
- "attributes": {
- "name": "status",
- "data_type": "string",
- "type_description": "Single Select",
- "custom_field": false
}
}, - {
- "id": "submitted_at",
- "type": "bid_fields",
- "attributes": {
- "name": "submitted_at",
- "data_type": "string",
- "type_description": "Date",
- "custom_field": false
}
}, - {
- "id": "resubmitted_at",
- "type": "bid_fields",
- "attributes": {
- "name": "resubmitted_at",
- "data_type": "string",
- "type_description": "Date",
- "custom_field": false
}
}, - {
- "id": "event",
- "type": "bid_fields",
- "attributes": {
- "name": "event",
- "data_type": "object",
- "type_description": "Single Relationship",
- "custom_field": false
}
}, - {
- "id": "supplier_company",
- "type": "bid_fields",
- "attributes": {
- "name": "supplier_company",
- "data_type": "object",
- "type_description": "Single Relationship",
- "custom_field": false
}
}
], - "links": { }
}
type required | string (BidLineItemType) Object type, should always be |
id required | integer (BidLineItemId) BidLineItem identifier string. |
object (BidLineItemAttributes) BidLineItem attributes. | |
object (BidLineItemRelationship) Bid line item relationship. |
{- "id": "1",
- "type": "bid_line_items",
- "attributes": {
- "data": {
- "c4": 10,
- "c5": 10
}, - "updated_at": "2021-02-24T21:36:51.982Z"
}, - "relationships": {
- "line_item": {
- "data": {
- "id": "1",
- "type": "line_items"
}
}, - "bid": {
- "data": {
- "id": "1",
- "type": "bids"
}
}, - "event": {
- "data": {
- "id": "1",
- "type": "events"
}
}, - "worksheet": {
- "data": {
- "id": "1",
- "type": "worksheets"
}
}
}
}
List Bid Line Items
Returns a list of line items for a specific bid.
Authorizations:
path Parameters
bid_id required | integer Example: 1 Bid identifier. |
Responses
Request samples
- Curl
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" \ "https://api.us.workdayspend.com/services/events/v1/bids/1/bid_line_items"
Response samples
- 200
{- "data": [
- {
- "id": "1",
- "type": "bid_line_items",
- "attributes": {
- "data": {
- "c4": 300.1,
- "c5": 60.02
}, - "updated_at": "2021-02-24T21:42:17.783Z"
}, - "relationships": {
- "line_item": {
- "data": {
- "id": "1",
- "type": "line_items"
}
}, - "bid": {
- "data": {
- "id": "1",
- "type": "bids"
}
}, - "event": {
- "data": {
- "id": "1",
- "type": "events"
}
}, - "worksheet": {
- "data": {
- "id": "1",
- "type": "worksheets"
}
}
}
}, - {
- "id": "2",
- "type": "bid_line_items",
- "attributes": {
- "data": {
- "c4": 200.44,
- "c5": 50.11
}, - "updated_at": "2021-02-24T21:42:17.783Z"
}, - "relationships": {
- "line_item": {
- "data": {
- "id": "2",
- "type": "line_items"
}
}, - "bid": {
- "data": {
- "id": "1",
- "type": "bids"
}
}, - "event": {
- "data": {
- "id": "1",
- "type": "events"
}
}, - "worksheet": {
- "data": {
- "id": "1",
- "type": "worksheets"
}
}
}
}
], - "links": {
}, - "meta": {
- "count": 2
}
}
Get a Bid Line Item
Retrieves the details of an existing bid line item.
Authorizations:
path Parameters
id required | integer Example: 1 Unique bid line item identifier. |
Responses
Request samples
- Curl
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" \ "https://api.us.workdayspend.com/services/events/v1/bid_line_items/1"
Response samples
- 200
{- "data": {
- "id": "1",
- "type": "bid_line_items",
- "attributes": {
- "data": {
- "c4": 300.1,
- "c5": 60.02
}, - "updated_at": "2021-02-24T21:42:17.783Z"
}, - "relationships": {
- "line_item": {
- "data": {
- "id": "1",
- "type": "line_items"
}
}, - "bid": {
- "data": {
- "id": "1",
- "type": "bids"
}
}, - "event": {
- "data": {
- "id": "1",
- "type": "events"
}
}, - "worksheet": {
- "data": {
- "id": "1",
- "type": "worksheets"
}
}
}
}
}
List All Bid Line Items
Returns a list of all bid line items.
Authorizations:
query Parameters
object (BidLineItemInputFilter) Filter bid line items by multiple criteria. Only one filter per attribute is supported. For best performance, we recommend 5 or less filters. |
Responses
Request samples
- Curl
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" \ "https://api.us.workdayspend.com/services/events/v1/bid_line_items"
Response samples
- 200
{- "data": [
- {
- "id": "1",
- "type": "bid_line_items",
- "attributes": {
- "data": {
- "c4": 300.1,
- "c5": 60.02
}, - "updated_at": "2021-02-24T21:42:17.783Z"
}, - "relationships": {
- "line_item": {
- "data": {
- "id": "1",
- "type": "line_items"
}
}, - "bid": {
- "data": {
- "id": "1",
- "type": "bids"
}
}, - "event": {
- "data": {
- "id": "1",
- "type": "events"
}
}, - "worksheet": {
- "data": {
- "id": "1",
- "type": "worksheets"
}
}
}
}, - {
- "id": "2",
- "type": "bid_line_items",
- "attributes": {
- "data": {
- "c4": 200.44,
- "c5": 50.11
}, - "updated_at": "2021-02-24T21:42:17.783Z"
}, - "relationships": {
- "line_item": {
- "data": {
- "id": "2",
- "type": "line_items"
}
}, - "bid": {
- "data": {
- "id": "1",
- "type": "bids"
}
}, - "event": {
- "data": {
- "id": "1",
- "type": "events"
}
}, - "worksheet": {
- "data": {
- "id": "1",
- "type": "worksheets"
}
}
}
}
], - "links": {
}, - "meta": {
- "count": 2
}
}
Describe Bid Line Item Object
Returns a list of fields for bid line item object.
Authorizations:
Responses
Request samples
- Curl
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" \ "https://api.us.workdayspend.com/services/events/v1/bid_line_items/describe"
Response samples
- 200
{- "data": [
- {
- "id": "data",
- "type": "bid_line_item_fields",
- "attributes": {
- "name": "data",
- "data_type": "string",
- "type_description": "Lookup",
- "custom_field": false
}
}, - {
- "id": "updated_at",
- "type": "bid_line_item_fields",
- "attributes": {
- "name": "updated_at",
- "data_type": "string",
- "type_description": "Date",
- "custom_field": false
}
}, - {
- "id": "event",
- "type": "bid_line_item_fields",
- "attributes": {
- "name": "event",
- "data_type": "object",
- "type_description": "Single Relationship",
- "custom_field": false
}
}, - {
- "id": "bid",
- "type": "bid_line_item_fields",
- "attributes": {
- "name": "bid",
- "data_type": "object",
- "type_description": "Single Relationship",
- "custom_field": false
}
}, - {
- "id": "worksheet",
- "type": "bid_line_item_fields",
- "attributes": {
- "name": "worksheet",
- "data_type": "object",
- "type_description": "Single Relationship",
- "custom_field": false
}
}, - {
- "id": "line_item",
- "type": "bid_line_item_fields",
- "attributes": {
- "name": "line_item",
- "data_type": "object",
- "type_description": "Single Relationship",
- "custom_field": false
}
}
], - "links": { },
- "meta": {
- "count": 6
}
}