- 05 Jun 2024
- Print
- PDF
OData Syntax & Query Parameter Options
- Updated on 05 Jun 2024
- Print
- PDF
You must follow OData syntax to format query parameters in the API. The syntax governs how URI statements are constructed, so it is essential to follow to initiate queries appropriately. The exact syntax and available functions within Aspire are consistent with OData V4.
Use the described query options to retrieve and manipulate data returned in a request. All OData query options within the Aspire External API definition are prefixed with $. The query options that are described below can be used separately or combined. The same query option can not be repeated multiple times.
Difference between RESTful OData and traditional REST API query parameters
Aspire uses OData query parameters to retrieve, build, and manage data. While RESTful API using OData and REST APIs are very similar, there are some key differences to know so that you can be sure to execute requests that return or manipulate information as you intend.
REST API query parameters can be unique and don't require adherence to a specific protocol, allowing variation in how query parameters can be formatted. OData, on the other hand, provides a standardized way of interacting with information across systems and requires following the syntax to create query parameters correctly.
Syntax nuances
In addition to the basic syntax rules described below, you will also want to keep the following information in mind.
- When filtering a string data type, use single quotes to enclose the field value.
- If the data type is boolean, integer, decimal, or DateTime then it doesn't matter if you use single quotes.
- Use parentheses when grouping conditions within an expression. E.g., (Active eq true) and (BranchName eq West)
- OData is case-sensitive.
- Whitespace within a value can impact your query. So, avoid using unneeded whitespace when assigning a value to a field or property.
- The commonly followed query options are:
- $filter
- $orderby
- $top &$skip
- $select
- $expand
OData query symbols
In constructing a request or viewing a request URL, special characters appear or are required depending on the action(s) taken. Below is a list of definitions for these special characters to better understand their purpose.
OData Query Symbols | |
$ | Predefined for each query. Notes each query. If it is the first query option, a ? should appear first. If it is not the first query option, the & will appear before the ? symbol. |
? | Appears once after the resource and before the query parameters' string. It marks the end of the resource/endpoint and the start of the query option(s). |
& | Used to separate multiple parameters and will appear before the special character, marking the beginning of a new parameter, $. |
= | Indicates the use of a comparison operation with a query parameter. Appears before the property or field with which the comparison clause is made. |
Escape Special Charectars | |
%20 | Represents a space between an operator and a field or property |
%27 | Indicates single quotes. |
%24 | Represents the predefined $. |
Basic Query Structure
You will find these elements within the OData query option structure.
- The base URL (which is either going to be: https://cloudsandbox-api.youraspire.com or https://cloud-api.youraspire.com).
- The resource being accessed.
- The query parameter.
- The query syntax statement/clause.
- Some elements automatically populate or are predefined when using the API guide or the Swagger UI. Within the below examples provided for the query options, the options row displays how to format syntax statements within your queries.
OData query options
Query options are used with the idempotent GET method to create clauses based on your criteria. The query options discussed in this article are $filter,$orderby,$top,$skip, $limit,$select, and $pagenumber.
Similarities between API OData and SQL query parameters options
If you are familiar with SQL, the following table will help you better understand OData query options.
ODATA & SQL Query Equivalency Chart | |
$filter | WHERE |
$orderby | ORDER BY |
$top | TOP |
$skip | SKIP |
$limit | TOP |
$pagenumber | SKIP |
$select | SELECT |
$expand | JOIN |
Field and property query options
- Field - attribute within an object on a database table.
- Property - regulates how data stored in a field can be seen or changed.
- The fields and properties you can use in your query for a given endpoint are listed in the response schema $Array of object section.
$filter,$select, and $orderby can be used with fields and properties. The field or property must be placed in the string beside the query option you select.
- $filter - restricts record information that is returned.
- $orderby - defines the order of returned records
- $select - only the selected attribute is returned.
$filter
- The $filter query option is probably the most commonly used. It offers the ability to refine the conditions that must be met in the data returned when building a request. You can use this query with any field for a given endpoint.
- It can not be used on fields within a nested object or property without the $expand query option.
- Use comparison operators, logical operators, and built-in functions to create $filter clauses.
Operator table
The following provides an overview of the operators that can be used with the $filter query option.
Operator | Description |
Comparison - comparison operators are used to construct conditions that return data by comparing a property or value. | |
eq | Equal |
ne | Not Equal |
gt | Greater Than |
ge | Greater than or Equal |
lt | Less than |
le | Less than or Equal |
Logical - The logical operator informs the action that should be used to specify the information being returned from the endpoint you use to build your request. Combine conditions using the and, or, and not operators. Use parentheses () to indicate the order of operations when combining conditions. | |
and | Logical and |
or | Logical or |
not | Logical negation |
Comparison operators
Below is a list of examples of the described operators.
eq (equals)
Use to ensure that the data returned matches the value you selected to filter.
Example | |
Desired outcome | Retrieve a list of only active contact records. |
Base URL | https://cloud-api.youraspire.com |
Resource | Contacts |
Query Parameter | $filter |
Filter option | Active eq true |
Query | https://cloud-api.youraspire.com?$filter=Active eq true |
Example Response
[
{
"ContactID": 22536,
"CompanyID": 7885,
"CompanyName": "ACompany, Inc.",
"ContactTypeID": 1055,
"ContactTypeName": "Customer",
"OfficeAddress": {
"AddressID": 34195,
"AddressLine1": "Line 1",
"AddressLine2": "Line 2",
"City": "Saint Peters",
"StateProvinceCode": "MO",
"ZipCode": "63376",
"CreatedByUserId": 3979,
"CreatedOn": "2023-04-15T04:30:02.61Z",
"LastModifiedByUserId": 3316,
"LastModifiedOn": "2023-04-17T04:30:02.61Z"
},
"HomeAddress": {
"AddressID": 44787,
"AddressLine1": "Line 1",
"AddressLine2": "Line 2",
"City": "Saint Charles",
"StateProvinceCode": null,
"ZipCode": "71000",
"CreatedByUserId": 3979,
"CreatedOn": "2023-04-15T04:30:02.61Z",
"LastModifiedByUserId": 3316,
"LastModifiedOn": "2023-04-17T04:30:02.61Z"
},
"BranchID": 50,
"BranchName": "St. Louis",
"OwnerContactID": 22597,
"OwnerContactName": "Bill Tower",
"Salutation": null,
"FirstName": "Bill",
"LastName": "Tower",
"ProspectRating": "2",
"ProspectRatingName": "Warm",
"Title": "Ownerr",
"Email": "email@gmail.com",
"MobilePhone": null,
"OfficePhone": "(333) 333-3333",
"HomePhone": "(333) 333-3333",
"Fax": null,
"Notes": "Testing Save in Mobile",
"Active": true,
"CreatedDateTime": null,
"CreatedByUserID": null,
"CreatedByUserName": null,
"EmployeeNumber": "1164",
"Website": null,
"EmployeePin": "9219009",
"AccountingSyncID": "1",
"ExternalContactReference": "2",
"TerminationDate": "2020-04-21T00:00:00Z",
"HRNotes": null,
"DefaultWorkersCompID": 13,
"DefaultWorkersCompName": "Brick Laying",
"DefaultWorkersCompStateProvinceCode": "AL",
"UserID": 3197,
"CrewSize": null,
"PromptForCrewSize": false,
"SubCrewLeaderContactID": null,
"PayScheduleID": 38,
"ModifiedDate": "2023-12-21T11:22:21.49Z",
"ContactTags": []
}
Code Sample
curl --request GET \
--url ("https://cloud-api.youraspire.com/Contacts?%24filter=Active%20eq%20false")
--header ("Authorization", "eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJIjoiNDg0OCIsIlVzZXJQZXJtaXNzaW9ucyI6IntcIsXCJSb2xlTmFtZVwiOm51bGwsXCJSZXF1aXJlZFwiOmZhbHNlLFwiUm9sZVZhbHVlXCI6MSxcIkFkZENvbnRhY3RcIjp0cnVlLFwiRWRpdE15Q29udGFjdHNcIjp0cnVlLFwiRWRpdEFsbENvbnRhY3RzXCI6dHJ1ZSxcIkRlbGV0ZUNvbnRhY3RcIjpmYWxzZSxcIkFkZEVtcGxveWVlSW5jaWRlbnRcIjp0cnVlLFwiRWRpdEFjY291bnRpbmdTeW5jSURcIjp0cnVlLFwiQnVsa0VtYWlsQ29udGFjdHNcIjp0cnVlLFwiU2VuZEN1c3RvbWVyUG9ydGFsSW52aXRhdGlvblwiOnRydWUsXCJJbXBvcnRDb250YWN0QW5kUHJvcGVydHlcIjp0cnVlLFwiQ29uZmlndXJlQ29udGFjdFJlcXVpcmVkRmllbGRzXCI6dHJ1ZSxcIkRlbGV0ZU1lcmdlQ29udGFjdHNcIjp0cnVlLFwiVXBkYXRlRW1wbG95ZWVQSU5cIjpmYWxzZSxcIkFkZFByb3BlcnR5XCI6dHJ1ZSxcIkVkaXRNeVByb3BlcnRpZXNcIjp0cnVlLFwiRWRpdEFsbFByb3BlcnRpZXNcIjp0cnVlLFwiRGVsZXRlUHJvcGVydHlcIjpmYWxzZSxcIkVkaXRRdWFsaXR5QXVkaXRzXCI6dHJ1ZSxcIlZpZXdQcm9wZXJ0aWVzXCI6dHJ1ZSxcIlZpZXdNeVByb3BlcnRpZXNcIjpmYWxzZSxcIkFkZE9wcG9ydHVuaXR5XCI6dHJ1ZSxcIkVkaXRNeU9wcG9ydHVuaXRpZXNcIjp0cnVlLFwiRWRpdEFsbE9wcG9ydHVuaXRpZXNcIjp0cnVlLFwiRGVsZXRlT3Bwb3J0dW5pdHlcIjp0cnVlLFwiQ2hhbmdlT3Bwb3J0dW5pdHlcIjp0cnVlLFwiVmlld1JlYWRPbmx5RXN0aW1hdGVzXCI6dHJ1ZSxcIlVuY2FuY2VsT3Bwb3J0dW5pdHlcIjp0cnVlLFwiSm9iRGFzaGJvYXJkXCI6dHJ1ZSxcIkltcG9ydEVzdGltYXRlXCI6dHJ1ZSxcIkVkaXRTZXJ2aWNlUGF5Q29kZXNcIjp0cnVlLFwiRGVsZXRlQWN0aXZpdHlcIjp0cnVlLFwiU3lzdGVtQWRtaW5cIjp0cnVlLFwiQnJhbmNoQWRtaW5cIjpmYWxzZSxcIlZpZXdSb3V0ZXNcIjp0cnVlLFwiTWFuYWdlT3Bwb3J0dW5pdHlUZW1wbGF0ZXNcIjp0cnVlLFwiTWFuYWdlR2VuZXJhbENvbmRpdGlvblRlbXBsYXRlc1wiOnRydWUsXCJNYWtlVmlzaXRDaGVja2xpc3RJdGVtc01hbmRhdG9yeVwiOnRydWUsXCJFZGl0RGFpbHlQbGFuUmVwb3J0XCI6dHJ1ZSxcIk1hcmtldGluZ1Byb1wiOnRydWUsXCJFeHBvcnRHcmlkc1wiOnRydWUsXCJFZGl0VGVtcGxhdGVzXCI6dHJ1ZSxcIk1hbmFnZVRlbXBsYXRlc1wiOnRydWUsXCJFZGl0RXN0aW1hdGVQcmljaW5nUGN0XCI6dHJ1ZSxcIkVkaXRFc3RpbWF0ZUl0ZW1zXCI6dHJ1ZSxcIkhvdXJSZWR1Y3Rpb25QY3RcIjoxMDAuMCxcIlByaWNlUmVkdWN0aW9uUGN0XCI6MTAwLjAsXCJVbmJhbGFuY2VkUGF5bWVudFNjaGVkdWxlXCI6dHJ1ZSxcIkFsbG93T25lVGltZUl0ZW1zXCI6dHJ1ZSxcIkFkZEl0ZW1zVG9DYXRhbG9nXCI6dHJ1ZSxcIkNoYW5nZVNlcnZpY2VJbnZvaWNlVHlwZU9uRml4ZWRQcmljZU9wZW5CaWxsaW5nXCI6dHJ1ZSxcIkFkanVzdEdlbmVyYWxDb25kaXRpb25zXCI6dHJ1ZSxcIkFkZE1vZGlmeVBheWNvZGVPdmVycmlkZXNcIjp0cnVlLFwiQXNOZWVkZWRFeGNlcHRpb25SZXBvcnRcIjp0cnVlLFwiTWFrZU9wcG9ydHVuaXR5U2VydmljZVZpc2l0Q2hlY2tsaXN0SXRlbXNNYW5kYXRvcnlcIjp0cnVlLFwiUHJvZHVjdGlvblwiOmZhbHNlLFwiVXBkYXRlSm9iXCI6ZmFsc2UsXCJDYW5jZWxXb3JrVGlja2V0XCI6dHJ1ZSxcIlNjaGVkdWxlQm9hcmRcIjp0cnVlLFwiU2NoZWR1bGVCb2FyZFJlYWRPbmx5XCI6dHJ1ZSxcIlJvdXRlT3B0aW1pemF0aW9uXCI6dHJ1ZSxcIlNjaGVkdWxlQW5FdmVudFwiOnRydWUsXCJBY2Nlc3NBdXRvVGltZUFjY2VwdGFuY2VSZXBvcnRzXCI6ZmFsc2UsXCJFZGl0Um91dGVzXCI6dHJ1ZSxcIkNyZXdMZWFkZXJcIjp0cnVlLFwiRXN0aW1hdGVcIjpmYWxzZSxcIlZpZXdBbGxUaW1lXCI6dHJ1ZSxcIk15UmVwb3J0c1wiOnRydWUsXCJBZHZhbmNlZFNlYXJjaFN5c3RlbUFkbWluXCI6ZmFsc2UsXCJIUkFkbWluXCI6dHJ1ZSxcIlNhbGVzTWFuYWdlclwiOnRydWUsXCJFZGl0UHJvcGVydHlCaWxsaW5nQ29udGFjdFwiOnRydWUsXCJVbmFwcHJvdmVSZWNlaXB0XCI6dHJ1ZSxcIkFwcHJvdmVUaW1lXCI6dHJ1ZSxcIkV4cG9ydFRpbWVcIjp0cnVlLFwiRWRpdFByaWNpbmdcIjp0cnVlLFwiQ2hvb3NlUmVwb3J0RXhwb3J0VHlwZVwiOnRydWUsXCJFZGl0QnVkZ2V0XCI6dHJ1ZSxcIlVuYXBwcm92ZVRpbWVcIjp0cnVlLFwiVmlld1JlYWRPbmx5UGF5cm9sbERhdGFcIjp0cnVlLFwiSW5vdmFMYWJvckJ1cmRlblRydWVVcFwiOnRydWUsXCJDcmVhdGVPdmVyVW5kZXJBZGp1c3RtZW50UmVjb3Jkc1wiOnRydWUsXCJDcmVhdGVSZWNlaXB0XCI6dHJ1ZSxcIkFwcHJvdmVSZWNlaXB0XCI6dHJ1ZSxcIkRlbGV0ZVJlY2VpcHRcIjp0cnVlLFwiQWRkUHVyY2hhc2VDcmVkaXRcIjp0cnVlLFwiU3VibWl0UmVjZWlwdFRvTGFuZHNjYXBlSHViXCI6dHJ1ZSxcIkFsbG93RXN0aW1hdGVOZWdhdGl2ZVF1YW50aXR5XCI6dHJ1ZSxcIkNyZWF0ZUludm9pY2VcIjp0cnVlLFwiVmlld0ludm9pY2luZ1wiOnRydWUsXCJFZGl0SW52b2ljaW5nXCI6dHJ1ZSxcIkRlbGV0ZUludm9pY2luZ1wiOnRydWUsXCJDcmVhdGVNaXNjSW52b2ljZVwiOmZhbHNlLFwiVmlld0FSTWFuYWdlbWVudFwiOnRydWUsXCJFZGl0QmlsbGluZ1wiOnRydWUsXCJWaWV3UHVyY2hhc2luZ1wiOnRydWUsXCJWaWV3UmV2ZW51ZVwiOnRydWUsXCJWaWV3UmVwb3J0c1wiOnRydWUsXCJDb21wbGV0ZVdvcmtUaWNrZXRcIjp0cnVlLFwiQXBwcm92ZVdvcmtUaWNrZXRcIjp0cnVlLFwiRGVsZXRlV29ya1RpY2tldFwiOnRydWUsXCJTd2FwQXNOZWVkZWRTZXJ2aWNlc1wiOnRydWUsXCJQYXJ0aWFsT2NjdXJcIjp0cnVlLFwiTW92ZVdvcmtUaWNrZXRDb3N0c1wiOnRydWUsXCJWaWV3T3Bwb3J0dW5pdGllc1wiOnRydWUsXCJWaWV3TXlPcHBvcnR1bml0aWVzXCI6ZmFsc2UsXCJXaW5Db250cmFjdFwiOnRydWUsXCJXaW5Xb3JrT3JkZXJcIjp0cnVlLFwiTG9zZU9wcG9ydHVuaXRpZXNcIjp0cnVlLFwiQWRkQ3JlZGl0TWVtb1wiOnRydWUsXCJUaWNrZXRCdWxrRW1haWxcIjp0cnVlLFwiRWRpdEJ1ZGdldGVkSG91ckFuZFJldmVudWVcIjp0cnVlLFwiUmVwb3J0QWNjZXNzXCI6e30sXCJNb2RpZnlTZW50SW52b2ljZXNcIjp0cnVlLFwiQWRkQ3Jld0xlYWRlckNvbnRhY3RcIjp0cnVlLFwiT3ZlcnJpZGVUb3RhbENvc3RcIjp0cnVlLFwiRWRpdEVhcm5lZFJldmVudWVcIjp0cnVlLFwiVmlld0tQSU92ZXJoZWFkUmVjb3ZlcnlcIjp0cnVlLFwiVmlld0tQSUNsaWVudE1hbmFnZW1lbnRcIjp0cnVlLFwiVmlld0tQSVByb2ZpdExvc3NcIjp0cnVlLFwiVmlld0tQSUZvcmVjYXN0XCI6dHJ1ZSxcIlZpZXdLUElDb21wbGV0ZWRMYWJvckVmZmljaWVuY3lcIjp0cnVlLFwiVmlld0tQSVNhbGVzU2NvcmVDYXJkXCI6dHJ1ZSxcIlZpZXdTYWxlc1BpcGVsaW5lSW5zaWdodFwiOnRydWUsXCJWaWV3Q3VzdG9tZXJJc3N1ZXNJbnNpZ2h0XCI6dHJ1ZSxcIkNsb3NlTW9udGhcIjp0cnVlLFwiQXBwcm92ZUVxdWlwbWVudFwiOnRydWUsXCJEaXNwb3NlRXF1aXBtZW50XCI6dHJ1ZSxcIkRlbGV0ZUVxdWlwbWVudFwiOnRydWUsXCJFcXVpcG1lbnRBZG1pblwiOnRydWUsXCJNYXJrRXF1aXBtZW50SW5TZXJ2aWNlXCI6dHJ1ZSxcIk1hcmtFcXVpcG1lbnRPdXRPZlNlcnZpY2VcIjp0cnVlLFwiUHVyY2hhc2VFcXVpcG1lbnRcIjp0cnVlLFwiUmVxdWVzdEVxdWlwbWVudFwiOnRydWUsXCJWaWV3RXF1aXBtZW50XCI6dHJ1ZSxcIkVzdGltYXRlQ3VzdG9tQ29sdW1uXCI6dHJ1ZSxcIlRyaWdnZXJBdXRvRXhwZW5zZUNyZWF0aW9uXCI6dHJ1ZSxcIlJvdXRlU2NoZWR1bGluZ1wiOnRydWUsXCJBZGRGdWVsUmF0ZVwiOnRydWUsXCJGdWVsQ29zdFJlcG9ydFwiOnRydWUsXCJNYW5hZ2VDdXN0b21GaWVsZHNcIjp0cnVlLFwiUHJvY2Vzc0VsZWN0cm9uaWNQYXltZW50c1wiOnRydWUsXCJWb2lkRWxlY3Ryb25pY1BheW1lbnRzXCI6dHJ1ZSxcIlJlZnVuZEVsZWN0cm9uaWNQYXltZW50c1wiOnRydWUsXCJFeHBpcmluZ0VsZWN0cm9uaWNQYXltZW50TWV0aG9kc0FsZXJ0c1wiOnRydWUsXCJSZWplY3RlZEVsZWN0cm9uaWNQYXltZW50c0FsZXJ0c1wiOnRydWUsXCJBbm51YWxSZW5ld2Fsc1wiOnRydWUsXCJWaWV3Q29tcGFuaWVzXCI6dHJ1ZSxcIkVkaXRDb21wYW5pZXNcIjp0cnVlLFwiQWRkQ29tcGFuaWVzXCI6dHJ1ZSxcIkNhbmNlbENvbnRyYWN0XCI6dHJ1ZSxcIkNhbmNlbFdvcmtPcmRlclwiOnRydWUsXCJNb2RpZnlTT1ZBZnRlck9wcG9ydHVuaXR5SXNXb25cIjp0cnVlLFwiQ2hhbmdlQXNzaWduZWRQcm9wZXJ0eUJyYW5jaFwiOnRydWUsXCJNYW5hZ2VVc2VyUm9sZXNcIjp0cnVlLFwiRWRpdEVxdWlwbWVudENvc3RBbmRIb3Vyc1wiOnRydWUsXCJDcmVhdGVFcXVpcG1lbnRJbnNwZWN0aW9uc1wiOnRydWUsXCJSZWNlaXZlUmVjZWlwdFwiOnRydWUsXCJNYW5hZ2VOb3RpZmljYXRpb25zU3lzdGVtXCI6dHJ1ZSxcIk1hbmFnZU5vdGlmaWNhdGlvbnNCcmFuY2hcIjp0cnVlLFwiUmVwb3J0V2ViRGVzaWduZXJcIjp0cnVlLFwiVmlld0ludmVudG9yeUxvY2F0aW9uc1wiOnRydWUsXCJFZGl0SW52ZW50b3J5TG9jYXRpb25zXCI6dHJ1ZSxcIlJvbGVQZXJtaXNzaW9uXCI6W10sXCJMb2NhbEJyYW5jaEFkbWluXCI6ZmFsc2UsXCJIYXNBbnlSZXBvcnRBY2Nlc3NcIjpmYWxzZX0iLCJBc3BpcmVTeXN0ZW1TZXR0aW5ncyI6IntcIkNvbXBhbnlOYW1lXCI6XCJJbmNyZWRpc2NhcGUgVUFUXCIsXCJFc3RpbWF0ZUxpY2Vuc2VcIjp0cnVlLFwiVGlja2V0TWFuYWdlbWVudExpY2Vuc2VcIjp0cnVlLFwiRXN0aW1hdGluZ1N0YWdpbmdcIjpmYWxzZSxcIkludm9pY2luZ0xpY2Vuc2VcIjp0cnVlLFwiQVJNYW5hZ2VtZW50TGljZW5zZVwiOnRydWUsXCJCaWxsaW5nRW1haWxGcm9tQWNjb3VudE93bmVyXCI6ZmFsc2UsXCJQYXljaGV4SW5jbHVkZURhdGVzXCI6dHJ1ZSxcIlJlcXVpcmVVbmlxdWVWZW5kb3JJbnZvaWNlTnVtYmVyXCI6ZmFsc2UsXCJSZXN0cmljdEVkaXRpbmdFbXBsb3llZXNcIjpmYWxzZSxcIkNyZWF0ZVByb3BlcnR5RnJvbUNvbnRhY3RcIjp0cnVlLFwiRW5hYmxlRWxlY3Ryb25pY1NpZ25hdHVyZXNcIjp0cnVlLFwiTWFzdGVyU3lzdGVtXCI6ZmFsc2UsXCJTbm93TW9kZVwiOnRydWUsXCJPcHBvcnR1bml0eUJyYW5jaE92ZXJyaWRlXCI6dHJ1ZSxcIlJvdW5kQ2xvY2tJbk91dFRpbWVzXCI6ZmFsc2UsXCJPTEFQUGl2b3RFbmFibGVkXCI6dHJ1ZSxcIkRpc2FibGVBdXRvbWF0aWNBcHByb3ZhbFwiOnRydWUsXCJEaXNhYmxlTW9iaWxlQ3Jld01hbmFnZW1lbnRcIjpmYWxzZSxcIkRpc2FibGVEZWxldGlvbk9mV29ya1RpY2tldHNcIjpmYWxzZSxcIkFsbG93U3ViVG9Mb2dpblwiOnRydWUsXCJIaWRlU2NoZWR1bGVQcm9ncmVzc0JhclwiOmZhbHNlLFwiV2Fybk9uRWFybHlMdW5jaENsb2NraW5cIjoyLFwiQ2FsaWZvcm5pYVRpbWVQcm9tcHRc19UaW1lQWNjZXB0YW5jZVwiOmZhbHNlLFwiRW50ZXJwcmlzZUFkbWluVHlwZVwiOjB9IiwiRm9yYmlkZGVuIjoiIiwibmJmIjoxNzA0Njg0Njc2LCJleHAiOjE3MDQ3NzEwNzYsImlhdCI6MTcwNDY4NDY3Nn0.FALf4zF0kIAf-pZPVmj8wChCDxGRaVuxQPHrzUy-Df0")
--header
("accept","application/json;odata.metadata=minimal;odata.streaming=true, application/json;odata.metadata=minimal;odata.streaming=false, application/json;odata.metadata=minimal, application/json;odata.metadata=full;odata.streaming=true, application/json;odata.metadata=full;odata.streaming=false, application/json;odata.metadata=full, application/json;odata.metadata=none;odata.streaming=true, application/json;odata.metadata=none;odata.streaming=false, application/json;odata.metadata=none, application/json;odata.streaming=true, application/json;odata.streaming=false, application/json, application/xml, application/prs.odatatestxx-odata, text/plain, text/json")
ne (not equal)
Use to ensure that the data returned does not match the value you selected to filter.
Example | |
Desired outcome | Only return results that do not contain user@email.com under a contact record. |
Base URL | https://cloud-api.youraspire.com |
Resource | Contacts |
Query Parameter | $filter |
Filter option | Email ne 'user@email.com' |
Query | https://cloud-api.youraspire.com?$filter=Email ne 'user@email.com' |
Example Response
[
{
"OpportunityID": 26382,
"PropertyID": 34246,
"OpportunityStatusID": 122,
"OpportunityStatusName": "1.Won",
"SalesRepContactID": 22596,
"SalesRepContactName": "Joe Smith",
"OperationsManagerContactID": null,
"OperationsManagerContactName": null,
"DivisionID": 90,
"DivisionName": "Enhancement",
"BranchID": 50,
"BranchName": "St. Louis",
"SalesTypeID": 29,
"SalesTypeName": "New Sale",
"TemplateOpportunityID": null,
"LeadSourceID": null,
"LeadSourceName": null,
"MasterOpportunityID": null,
"BillingAddressID": 39552,
"BillingAddressLine1": "6744 S Maple Court",
"BillingAddressLine2": null,
"BillingAddressCity": "Chancy",
"BillingAddressStateProvinceCode": "MO",
"BillingAddressZipCode": "63350",
"OpportunityType": "Work Order",
"MasterSequenceNum": null,
"OpportunityName": "Have Rambo Sign it",
"ProposalDescription1": null,
"StartDate": "2024-01-01T00:00:00Z",
"EndDate": "2024-01-31T00:00:00Z",
"BidDueDate": null,
"CreatedDateTime": "2019-02-01T20:36:00.787Z",
"ApprovedDate": "2024-01-03T12:07:46.903Z",
"ProposedDate": "2024-01-03T12:07:59.883Z",
"WonDate": "2024-01-03T12:08:55.357Z",
"LostDate": null,
"Probability": 100,
"AnticipatedCloseDate": null,
"InvoiceType": "Fixed Price on Completion",
"CustomerContractNum": null,
"CustomerPONum": null,
"BudgetedDollars": 0,
"EstimatedDollars": 286.74,
"StateTaxPercent": 5.5,
"FederalTaxPercent": 0,
"CreatedByUserID": 3317,
"CreatedByUserName": "Joe Smith",
"ApprovedUserID": 3643,
"ApprovedUserName": Judge Judy"
Code Sample
curl --request GET \
--url ("https://cloud-api.youraspire.com/Contacts?%24filter=Email%20ne%20'user%40email.com'")
--header ("Authorization", "eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJBc3BpcmVTeXN0ZW1JRCI6IjE1IiwiVXNlcklEIjoiNDg0OCIsIlVzZXJQZXJtaXNzaW9ucyI6IntcIlJvbGVJRFwiOjAsXCJSb2xlTmFtZVwiOm51bGwsXCJSZXF1aXJlZFwiOmZhbHNlLFwiUm9sZVZhbHVlXCI6MSxcIkFkZENvbnRhY3RcIjp0cnVlLFwiRWRpdE15Q29udGFjdHNcIjp0cnVlLFwiRWRpdEFsbENvbnRhY3RzXCI6dHJ1ZSxcIkRlbGV0ZUNvbnRhY3RcIjpmYWxzZSxcIkFkZEVtcGxveWVlSW5jaWRlbnRcIjp0cnVlLFwiRWRpdEFjY291bnRpbmdTeW5jSURcIjp0cnVlLFwiQnVsa0VtYWlsQ29udGFjdHNcIjp0cnVlLFwiU2VuZEN1c3RvbWVyUG9ydGFsSW52aXRhdGlvblwiOnRydWUsXCJJbXBvcnRDb250YWN0QW5kUHJvcGVydHlcIjp0cnVlLFwiQ29uZmlndXJlQ29udGFjdFJlcXVpcmVkRmllbGRzXCI6dHJ1ZSxcIkRlbGV0ZU1lcmdlQ29udGFjdHNcIjp0cnVlLFwiVXBkYXRlRW1wbG95ZWVQSU5cIjpmYWxzZSxcIkFkZFByb3BlcnR5XnRpZXNcIjpmYWxzZSxsT3Bwb3J0dW5pdHlcIjp0cnVlLFwiSm9iRGFzaGJvYXJkXCI6dHJ1ZSxcIkltcG9ydEVzdGltYXRlXCI6dHJ1ZSxcIkVkaXRTZXJ2aWNlUGFJhbmNoQWRtaW5cIjpmYWxzZSxcIlZpZXdSb3V0ZXNcIjp0cnVlLFwiTWFuYWdlT3Bwb3J0dW5pdHlUZW1wbGF0ZXNcIjp0cnVlLFwiTWFuYWdlR2VuZXJhbENvbmRpdGlvblRlbXBsYXRlc1wiOnRydWUsXCJNYWtlVmlzaXRDaGVja2xpc3RJdGVtc01hbmRhdG9yeVwiOnRydWUsXCJFZGl0RGFpbHlQbGFuUmVwb3J0XCI6dHJ1ZSxcIk1hcmtldGluZ1Byb1wiOnRydWUsXCJFeHBvcnRHcmlkc1wiOnRydWUsXCJFZGl0VGVtcGxhdGVzXCI6dHJ1ZSxcIk1hbmFnZVRlbXBsYXRlc1wiOnRydWUsXCJFZGl0RXN0aW1hdGVQcmljaW5nUGN0XCI6dHJ1ZSxcIkVkaXRFc3RpbWF0ZUl0ZW1zXCI6dHJ1ZSxcIkhvdXJSZWR1Y3Rpb25QY3RcIjoxMDAuMCxcIlByaWNlUmVkdWN0aW9uUGN0XCI6MTAwLjAsXCJVbmJhbGFuY2VkUGF5bWVudFNjaGVkdWxlXCI6dHJ1ZSxcIkFsbG93T25lVGltZUl0ZW1zXCI6dHJ1ZSxcIkFkZEl0ZW1zVG9DYXRhbG9nXCI6dHJ1ZSxcIkNoYW5nZVNlcnZpY2VJbnZvaWNlVHlwZU9uRml4ZWRQcmljZU9wZW5CaWxsaW5nXCI6dHJ1ZSxcIkFkanVzdEdlbmVyYWxDb25kaXRpb25zXCI6dHJ1ZSxcIkFkZE1vZGlmeVBheWNvZGVPdmVycmlkZXNcIjp0cnVlLFwiQXNOZWVkZWRFeGNlcHRpb25SZXBvcnRcIjp0cnVlLFwiTWFrZU9wcG9ydHVuaXR5U2VydmljZVZpc2l0Q2hlY2tsaXN0SXRlbXNNYW5kYXRvcnlcIjp0cnVlLFwiUHJvZHVjdGlvblwiOmZhbHNlLFwiVXBkYXRlSm9iXCI6ZmFsc2UsXCJDYW5jZWxXb3JrVGlja2V0XCI6dHJ1ZSxcIlNjaGVkdWxlQm9hcmRcIjp0cnVlLFwiU2NoZWR1bGVCb2FyZFJlYWRPbmx5XCI6dHJ1ZSxcIlJvdXRlT3B0aW1pemF0aW9uXCI6dHJ1ZSxcIlNjaGVkdWxlQW5FdmVudFwiOnRydWUsXCJBY2Nlc3NBdXRvVGltZUFjY2VwdGFuY2VSZXBvcnRzXCI6ZmFsc2UsXCJFZGl0Um91dGVzXCI6dHJ1ZSxcIkNyZXdMZWFkZXJcIjp0cnVlLFwiRXN0aW1hdGVcIjpmYWxzZSxcIlZpZXdBbGxUaW1lXCI6dHJ1ZSxcIk15UmVwb3J0c1wiOnRydWUsXCJBZHZhbmNlZFNlYXJjaFN5c3RlbUFkbWluXCI6ZmFsc2UsXCJIUkFkbWluXCI6dHJ1ZSxcIlNhbGVzTWFuYWdlclwiOnRydWUsXCJFZGl0UHJvcGVydHlCaWxsaW5nQ29udGFjdFwiOnRydWUsXCJVbmFwcHJvdmVSZWNlaXB0XCI6dHJ1ZSxcIkFwcHJvdmVUaW1lXCI6dHJ1ZSxcIkV4cG9ydFRpbWVcIjp0cnVlLFwiRWRpdFByaWNpbmdcIjp0cnVlLFwiQ2hvb3NlUmVwb3J0RXhwb3J0VHlwZVwiOnRydWUsXCJFZGl0QnVkZ2V0XCI6dHJ1ZSxcIlVuYXBwcm92ZVRpbWVcIjp0cnVlLFwiVmlld1JlYWRPbmx5UGF5cm9sbERhdGFcIjp0cnVlLFwiSW5vdmFMYWJvckJ1cmRlblRydWVVcFwiOnRydWUsXCJDcmVhdGVPdmVyVW5kZXJBZGp1c3RtZW50UmVjb3Jkc1wiOnRydWUsXCJDcmVhdGVSZWNlaXB0XCI6dHJ1ZSxcIkFwcHJvdmVSZWNlaXB0XCI6dHJ1ZSxcIkRlbGV0ZVJlY2VpcHRcIjp0cnVlLFwiQWRkUHVyY2hhc2VDcmVkaXRcIjp0cnVlLFwiU3VibWl0UmVjZWlwdFRvTGFuZHNjYXBlSHViXCI6dHJ1ZSxcIkFsbG93RXN0aW1hdGVOZWdhdGl2ZVF1YW50aXR5XCI6dHJ1ZSxcIkNyZWF0ZUludm9pY2VcIjp0cnVlLFwiVmlld0ludm9pY2luZ1wiOnRydWUsXCJFZGl0SW52b2ljaW5nXCI6dHJ1ZSxcIkRlbGV0ZUludm9pY2luZ1wiOnRydWUsXCJDcmVhdGVNaXNjSW52b2ljZVwiOmZhbHNlLFwiVmlld0FSTWFuYWdlbWVudFwiOnRydWUsXCJFZGl0QmlsbGluZ1wiOnRydWUsXCJWaWV3UHVyY2hhc2luZ1wiOnRydWUsXCJWaWV3UmV2ZW51ZVwiOnRydWUsXCJWaWV3UmVwb3J0c1wiOnRydWUsXCJDb21wbGV0ZVdvcmtUaWNrZXRcIjp0cnVlLFwiQXBwcm92ZVdvcmtUaWNrZXRcIjp0cnVlLFwiRGVsZXRlV29ya1RpY2tldFwiOnRydWUsXCJTd2FwQXNOZWVkZWRTZXJ2aWNlc1wiOnRydWUsXCJQYXJ0aWFsT2NjdXJcIjp0cnVlLFwiTW92ZVdvcmtUaWNrZXRDb3N0c1wiOnRydWUsXCJWaWV3T3Bwb3J0dW5pdGllc1wiOnRydWUsXCJWaWV3TXlPcHBvcnR1bml0aWVzXCI6ZmFsc2UsXCJXaW5Db250cmFjdFwiOnRydWUsXCJXaW5Xb3JrT3JkZXJcIjp0cnVlLFwiTG9zZU9wcG9ydHVuaXRpZXNcIjp0cnVlLFwiQWRkQ3JlZGl0TWVtb1wiOnRydWUsXCJUaWNrZXRCdWxrRW1haWxcIjp0cnVlLFwiRWRpdEJ1ZGdldGVkSG91ckFuZFJldmVudWVcIjp0cnVlLFwiUmVwb3J0QWNjZXNzXCI6e30sXCJNb2RpZnlTZW50SW52b2ljZXNcIjp0cnVlLFwiQWRkQ3Jld0xlYWRlckNvbnRhY3RcIjp0cnVlLFwiT3ZlcnJpZGVUb3RhbENvc3RcIjp0cnVlLFwiRWRpdEVhcm5lZFJldmVudWVcIjp0cnVlLFwiVmlld0tQSU92ZXJoZWFkUmVjb3ZlcnlcIjp0cnVlLFwiVmlld0tQSUNsaWVudE1hbmFnZW1lbnRcIjp0cnVlLFwiVmlld0tQSVByb2ZpdExvc3NcIjp0cnVlLFwiVmlld0tQSUZvcmVjYXN0XCI6dHJ1ZSxcIlZpZXdLUElDb21wbGV0ZWRMYWJvckVmZmljaWVuY3lcIjp0cnVlLFwiVmlld0tQSVNhbGVzU2NvcmVDYXJkXCI6dHJ1ZSxcIlZpZXdTYWxlc1BpcGVsaW5lSW5zaWdodFwiOnRydWUsXCJWaWV3Q3VzdG9tZXJJc3N1ZXNJbnNpZ2h0XCI6dHJ1ZSxcIkNsb3NlTW9udGhcIjp0cnVlLFwiQXBwcm92ZUVxdWlwbWVudFwiOnRydWUsXCJEaXNwb3NlRXF1aXBtZW50XCI6dHJ1ZSxcIkRlbGV0ZUVxdWlwbWVudFwiOnRydWUsXCJFcXVpcG1lbnRBZG1pblwiOnRydWUsXCJNYXJrRXF1aXBtZW50SW5TZXJ2aWNlXCI6dHJ1ZSxcIk1hcmtFcXVpcG1lbnRPdXRPZlNlcnZpY2VcIjp0cnVlLFwiUHVyY2hhc2VFcXVpcG1lbnRcIjp0cnVlLFwiUmVxdWVzdEVxdWlwbWVudFwiOnRydWUsXCJWaWV3RXF1aXBtZW50XCI6dHJ1ZSxcIkVzdGltYXRlQ3VzdG9tQ29sdW1uXCI6dHJ1ZSxcIlRyaWdnZXJBdXRvRXhwZW5zZUNyZWF0aW9uXCI6dHJ1ZSxcIlJvdXRlU2NoZWR1bGluZ1wiOnRydWUsXCJBZGRGdWVsUmF0ZVwiOnRydWUsXCJGdWVsQ29zdFJlcG9ydFwiOnRydWUsXCJNYW5hZ2VDdXN0b21GaWVsZHNcIjp0cnVlLFwiUHJvY2Vzc0VsZWN0cm9uaWNQYXltZW50c1wiOnRydWUsXCJWb2lkRWxlY3Ryb25pY1BheW1lbnRzXCI6dHJ1ZSxcIlJlZnVuZEVsZWN0cm9uaWNQYXltZW50c1wiOnRydWUsXCJFeHBpcmluZ0VsZWN0cm9uaWNQYXltZW50TWV0aG9kc0FsZXJ0c1wiOnRydWUsXCJSZWplY3RlZEVsZWN0cm9uaWNQYXltZW50c0FsZXJ0c1wiOnRydWUsXCJBbm51YWxSZW5ld2Fsc1wiOnRydWUsXCJWaWV3Q29tcGFuaWVzXCI6dHJ1ZSxcIkVkaXRDb21wYW5pZXNcIjp0cnVlLFwiQWRkQ29tcGFuaWVzXCI6dHJ1ZSxcIkNhbmNlbENvbnRyYWN0XCI6dHJ1ZSxcIkNhbmNlbFdvcmtPcmRlclwiOnRydWUsXCJNb2RpZnlTT1ZBZnRlck9wcG9ydHVuaXR5SXNXb25cIjp0cnVlLFwiQ2hhbmdlQXNzaWduZWRQcm9wZXJ0eUJyYW5jaFwiOnRydWUsXCJNYW5hZ2VVc2VyUm9sZXNcIjp0cnVlLFwiRWRpdEVxdWlwbWVudENvc3RBbmRIb3Vyc1wiOnRydWUsXCJDcmVhdGVFcXVpcG1lbnRJbnNwZWN0aW9uc1wiOnRydWUsXCJSZWNlaXZlUmVjZWlwdFwiOnRydWUsXCJNYW5hZ2VOb3RpZmljYXRpb25zU3lzdGVtXCI6dHJ1ZSxcIk1hbmFnZU5vdGlmaWNhdGlvbnNCcmFuY2hcIjp0cnVlLFwiUmVwb3J0V2ViRGVzaWduZXJcIjp0cnVlLFwiVmlld0ludmVudG9yeUxvY2F0aW9uc1wiOnRydWUsXCJFZGl0SW52ZW50b3J5TG9jYXRpb25zXCI6dHJ1ZSxcIlJvbGVQZXJtaXNzaW9uXCI6W10sXCJMb2NhbEJyYW5jaEFkbWluXCI6ZmFsc2UsXCJIYXNBbnlSZXBvcnRBY2Nlc3NcIjpmYWxzZX0iLCJBc3BpcmVTeXN0ZW1TZXR0aW5ncyI6IntcIkNvbXBhbnlOYW1lXCI6XCJJbmNyZWRpc2NhcGUgVUFUXCIsXCJFc3RpbWF0ZUxpY2Vuc2VcIjp0cnVlLFwiVGlja2V0TWFuYWdlbWVudExpY2Vuc2VcIjp0cnVlLFwiRXN0aW1hdGluZ1N0YWdpbmdcIjpmYWxzZSxcIkludm9pY2luZ0xpY2Vuc2VcIjp0cnVlLFwiQVJNYW5hZ2VtZW50TGljZW5zZVwiOnRydWUsXCJCaWxsaW5nRW1haWxGcm9tQWNjb3VudE93bmVyXCI6ZmFsc2UsXCJQYXljaGV4SW5jbHVkZURhdGVzXCI6dHJ1ZSxcIlJlcXVpcmVVbmlxdWVWZW5kb3JJbnZvaWNlTnVtYmVyXCI6ZmFsc2UsXCJSZXN0cmljdEVkaXRpbmdFbXBsb3llZXNcIjpmYWxzZSxcIkNyZWF0ZVByb3BlcnR5RnJvbUNvbnRhY3RcIjp0cnVlLFwiRW5hYmxlRWxlY3Ryb25pY1NpZ25hdHVyZXNcIjp0cnVlLFwiTWFzdGVyU3lzdGVtXCI6ZmFsc2UsXCJTbm93TW9kZVwiOnRydWUsXCJPcHBvcnR1bml0eUJyYW5jaE92ZXJyaWRlXCI6dHJ1ZSxcIlJvdW5kQ2xvY2tJbk91dFRpbWVzXCI6ZmFsc2UsXCJPTEFQUGl2b3RFbmFibGVkXCI6dHJ1ZSxcIkRpc2FibGVBdXRvbWF0aWNBcHByb3ZhbFwiOnRydWUsXCJEaXNhYmxlTW9iaWxlQ3Jld01hbmFnZW1lbnRcIjpmYWxzZSxcIkRpc2FibGVEZWxldGlvbk9mV29ya1RpY2tldHNcIjpmYWxzZSxcIkFsbG93U3ViVG9Mb2dpblwiOnRydWUsXCJIaWRlU2NoZWR1bGVQcm9ncmVzc0JhclwiOmZhbHNlLFwiV2Fybk9uRWFybHlMdW5jaENsb2NraW5cIjoyLFwiQ2FsaWZvcm5pYVRpbWVQcm9tcHRzXCI6ZmFsc2UsXCJJbnZvaWNpbmdBc3Npc3RhbnRSZXF1aXJlQmlsbGluZ0NvbXBhbnlcIjpmYWxzZSxcIkVuZm9yY2VCcmFuY2hBZG1pbkFkbWluaXN0cmF0aW9uU2VjdXJpdHlcIjp0cnVlLFwiT1RDYWxjdWxhdGlvblwiOlwiT3ZlcnJpZGUgUGF5Y29kZVwiLFwiRXF1aXBtZW50UmVhZGluZ0Nsb2NrT3V0UHJvbXB0XCI6XCJFbmQgb2YgRGF5XCIsXCJTaG93TmV0R3Jvc3NNYXJnaW5PbkVzdGltYXRpbmdTY3JlZW5cIjp0cnVlLFwiU2hvd09ubHlHcm9zc01hcmdpbm9uRXN0aW1hdGluZ1NjcmVlblwiOmZhbHNlLFwiQ3JlYXRlRXF1aXBtZW50UmVhZGluZ3NcIjp0cnVlLFwiSW5jbHVkZURyaXZlVGltZVdoZW5Mb2dnaW5nRXF1aXBtZW50Q3Jld01vYmlsZVwiOnRydWUsXCJFbmFibGVOZWdhdGl2ZUNoYW5nZU9yZGVyc1wiOnRydWUsXCJFbmFibGVDdXN0b21lclBvcnRhbFwiOnRydWUsXCJEZWZhdWx0R0VPUGVyaW1ldGVyXCI6NTAwLjAsXCJFbmFibGVBc3BpcmVHUFNJbnRlZ3JhdGlvblwiOnRydWUsXCJFbmFibGVFcXVpcG1lbnRNb2R1bGVBZGRPblwiOnRydWUsXCJHUFNJbnRlZ3JhdGlvblByb3ZpZGVyXCI6MyxcIkVuYWJsZUVsZWN0cm9uaWNQYXltZW50c1wiOnRydWUsXCJFbmFibGVTaXRlT25lXCI6ZmFsc2UsXCJCcmVha1RpbWVcIjowLjUsXCJQYXljaGV4RXhwb3J0Rm9ybWF0XCI6XCJEZWZhdWx0IENTVlwiLFwiRW5hYmxlUGFydGlhbFRpbWVPblN1YlBvcnRhbFwiOnRydWUsXCJFbmFibGVQYXJ0aWFsVGltZU9uQ3Jld01vYmlsZVwiOnRydWUsXCJFbmFibGVMYW5kc2NhcGVIdWJJbnRlZ3JhdGlvblwiOnRydWUsXCJEaXNwbGF5VGF4T25Fc3RpbWF0ZVwiOnRydWUsXCJMaW5rU2NoZWR1bGVvZlZhbHVldG9TZXJ2aWNlQnlEZWZhdWx0XCI6ZmFsc2UsXCJFbmFibGVXZWF0aGVybWF0aWNJbnRlZ3JhdGlvblwiOnRydWUsXCJBZHZhbmNlZFNlYXJjaFNlbGVjdFRvcE51bWJlclwiOjUwMDAsXCJFbmFibGVPdmVyVW5kZXJBZGp1c3RtZW50c1wiOnRydWUsXCJEZWZhdWx0RGl2aXNpb25JREZvcldvcmtPcmRlcnNcIjowLFwiRGVmYXVsdEZvbnRcIjpcIlZlcmRhbmEsc2Fucy1zZXJpZlwiLFwiRGVmYXVsdEZvbnRTaXplXCI6XCIxNC4wMFwiLFwiQ3Jld0xlYWRlclJvbGVJRFwiOjEyMDIsXCJSZXF1aXJlTm9PcGVuSW52b2ljZXNDaGVja1wiOnRydWUsXCJQcm9kdWN0VGllclwiOjAsXCJDYW5BY2Nlc3NBUElzXCI6ZmFsc2UsXCJIYXNGYWNpYWxSZWNcIjpmYWxzZSxcIkVuYWJsZVRha2VvZmZJbnRlZ3JhdGlvblwiOnRydWUsXCJUYWtlb2ZmSW50ZWdyYXRpb25UeXBlXCI6NyxcIkRlZmF1bHRQcm9wZXJ0eVRha2VvZmZQcm92aWRlclwiOjQsXCJEZWZhdWx0RXN0aW1hdGVUYWtlb2ZmUHJvdmlkZXJcIjo0LFwiRW5hYmxlV2ViUmVwb3J0RGVzaWduZXJcIjpmYWxzZSxcIkF6dWdhQ3VzdG9tZXJJRFwiOjEwNTksXCJFbmFibGVDcmV3TWVtYmVyQ2xvY2tJbldpdGhvdXRDcmV3TGVhZGVyXCI6ZmFsc2UsXCJFbmFibGVFT01SZXBvcnRcIjpmYWxzZSxcIlVzZU9wcG9ydHVuaXR5SXRlbURpc3BsYXlOYW1lT25JbnZvaWNlXCI6dHJ1ZSxcIkVuYWJsZVZpc2l0Q2hlY2tsaXN0c1wiOnRydWUsXCJUaW1lWm9uZVwiOlwiQW1lcmljYS9DaGljYWdvXCIsXCJGaXJzdERheU9mV2Vla1wiOlwiTW9uZGF5XCIsXCJJbm92YUVuYWJsZWRcIjp0cnVlLFwiUFRPVmlzaWJsZVwiOnRydWUsXCJNYXJrZXRpbmdQcm9JbnRlZ3JhdGlvblwiOmZhbHNlLFwiTWFya2V0aW5nUHJvVmVyc2lvblwiOm51bGwsXCJFbmFibGVBdXRvVGltZUFjY2VwdGFuY2VDb25maWdcIjpmYWxzZSxcIkVuYWJsZUF1dG9UaW1lQWNjZXB0YW5jZVwiOmZhbHNlLFwiRW50ZXJwcmlzZUFkbWluVHlwZVwiOjB9IiwiRm9yYmlkZGVuIjoiIiwibmJmIjoxNzA0Njg0Njc2LCJleHAiOjE3MDQ3NzEwNzYsImlhdCI6MTcwNDY4NDY3Nn0.FALf4zF0kIAf-pZPVmj8wChCDxGRaVuxQPHrzUy-Df0")
--header ("accept", "application/json;odata.metadata=minimal;odata.streaming=true, application/json;odata.metadata=minimal;odata.streaming=false, application/json;odata.metadata=minimal, application/json;odata.metadata=full;odata.streaming=true, application/json;odata.metadata=full;odata.streaming=false, application/json;odata.metadata=full, application/json;odata.metadata=none;odata.streaming=true, application/json;odata.metadata=none;odata.streaming=false, application/json;odata.metadata=none, application/json;odata.streaming=true, application/json;odata.streaming=false, application/json, application/xml, application/prs.odatatestxx-odata, text/plain, text/json")
gt (greater than)
Use to ensure the data returned is greater than the value you selected to filter.
Example | |
Desired outcome | Return opportunities that contain an anticipated close date greater than 12/15/2023. |
Base URL | https://cloud-api.youraspire.com |
Resource | Opportunities |
Query Parameter | $filter |
Filter option | AntcipatedClosedDate gt 2023-12-15 |
Query | https://cloud-api.youraspire.com?$filter=AntcipatedClosedDate gt 2023-12-15 |
Example Response
[
{
"OpportunityID": 45237,
"PropertyID": 34481,
"OpportunityStatusID": 122,
"OpportunityStatusName": "1.Won",
"SalesRepContactID": 25162,
"SalesRepContactName": "A Name",
"OperationsManagerContactID": 24843,
"OperationsManagerContactName": "A Route Manager",
"DivisionID": 90,
"DivisionName": "Enhancement",
"BranchID": 176,
"BranchName": "Illinois",
"SalesTypeID": 29,
"SalesTypeName": "New Sale",
"TemplateOpportunityID": null,
"LeadSourceID": null,
"LeadSourceName": null,
"MasterOpportunityID": null,
"BillingAddressID": 149468,
"BillingAddressLine1": "4900 HOMER DR Denali AK 99503-7531 USA",
"BillingAddressLine2": "1920 E BLVD ANCHORAGE AK 99507-2661 USA",
"BillingAddressCity": "Anchorage",
"BillingAddressStateProvinceCode": "AL",
"BillingAddressZipCode": "99540",
"OpportunityType": "Contract",
"MasterSequenceNum": null,
"OpportunityName": "AC-18291",
"ProposalDescription1": null,
"StartDate": "2023-12-13T00:00:00Z",
"EndDate": "2023-12-13T00:00:00Z",
"BidDueDate": null,
"CreatedDateTime": "2023-12-13T21:10:33.063Z",
"ApprovedDate": "2023-12-13T21:12:46.687Z",
"ProposedDate": "2023-12-13T21:14:30.55Z",
"WonDate": "2023-12-13T21:14:30.55Z",
"LostDate": null,
"Probability": 100,
"AnticipatedCloseDate": "2024-12-13T00:00:00Z",
"InvoiceType": "Fixed Payment",
"CustomerContractNum": null,
"CustomerPONum": null,
"BudgetedDollars": 0,
"EstimatedDollars": 3120,
"StateTaxPercent": 5.5,
"FederalTaxPercent": 0,
"CreatedByUserID": 3638,
"CreatedByUserName": "A Name",
"ApprovedUserID": 3638,
"ApprovedUserName": "A Name",
"ProposedUserID": 3638,
"ProposedUserName": "A Name",
"ClosedUserID": 3638,
"ClosedUserName": "A Name",
"CompetitorID": null,
"CompetitorName": null,
"LostReason": null,
"BillingContactID": 42937,
"BillingContactName": "Judge Judy",
"ProposalDescription2": null,
"OpportunityNumber": 20268,
"EstimatedCostDollars": 3120,
"EstimatedOverheadDollars": 0,
"EstimatedBreakEvenDollars": 3120,
"EstimatedNetProfitPercent": 0,
"EstimatedNetProfitDollars": 0,
"EstimatedGrossMarginPercent": 0,
"EstimatedGrossMarginDollars": 0,
"EstimatedLaborHours": 104,
"EstimatedLaborCostPerHour": 30,
"EstimatedRealizeRate": 30,
"EstimatedEquipmentCost": 0,
"EstimatedLaborCost": 3120,
"EstimatedMaterialCost": 0,
"EstimatedOtherCost": 0,
"EstimatedSubCost": 0,
"ActualCostDollars": 0,
"ActualGrossMarginPercent": 0,
"ActualGrossMarginDollars": 0,
"ActualLaborHours": 0,
"ActualLaborCostPerHour": 0,
"ActualEarnedRevenue": 0,
"InvoiceNote": null,
"PercentComplete": 0,
"RenewalDate": "2023-12-13T00:00:00Z",
"ModifiedByUserID": 3638,
"ModifiedByUserName": "QA1 QA",
"ModifiedDate": "2023-12-13T21:59:24.627Z",
"OverridePaymentTermsID": null,
"OverridePaymentTerms": null,
"RetainagePercent": null,
"EstimatorNotes": null,
"ElectronicPaymentsOverrideConvenienceFee": null,
"OpportunityCanceledReasonID": 11,
"OpportunityCanceledReason": "IB Canceled Opportunity Reason",
"RetainageMaturityDate": null,
"DistrictName": "District West13",
"JobStatusName": "Canceled",
"RegionName": "Southwest Region",
"PaymentTermsID": 40,
"BillingCompanyID": 7713,
"BillingCompanyName": "Aspire",
"BranchCode": "dasdas",
"PropertyName": "#123 Costco",
"DivisionCode": "EN",
"TaxablePercent": 100,
"TaxableAmount": 3120,
"TMPerServiceTaxableAmount": 0,
"ActualCostSub": 0,
"ActualCostMaterial": 0,
"ActualCostLabor": 0,
"CompleteDate": null,
"OpportunityRevisions": [],
"OpportunityBillings": [
{
"OpportunityBillingID": 46010,
"OpportunityBillingRefID": null,
"BillMonth": 12,
"InvoiceDescription": null,
"InvoiceTriggerPercent": null,
"InvoiceAmount": 3120,
"SortOrder": 1,
"Active": true,
"OpportunityRevisionID": null
}
],
"ScheduleOfValueGroups": []
},
]
Code Sample
curl --request GET \
--url ("https://cloud-api.youraspire.com//Opportunities?%24filter=AnticipatedCloseDate%20gt%202023-12-15")
--header ("Authorization", "eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJBc3BpcmVTeXN0ZW1JRCI6IjE1IiwiVXNlcklEIjoiNDg0OCIsIlVzZXJQZXJtaXNzaW9ucyI6IntcIlJvbGVJRFwiOjAsXCJSb2xlTmFtZVwiOm51bGwsXCJSZXF1aXJlZFwiOmZhbHNlLFwiUm9sZVZhbHVlXCI6MSxcIkFkZENvbnRhY3RcIjp0cnVlLFwiRWRpdE15Q29udGFjdHNcIjp0cnVlLFwiRWRpdEFsbENvbnRhY3RzXCI6dHJ1ZSxcIkRlbGV0ZUNvbnRhY3RcIjpmYWxzZSxcIkFkZEVtcGxveWVlSW5jaWRlbnRcIjp0cnVlLFwiRWRpdEFjY291bnRpbmdTeW5jSURcIjp0cnVlLFwiQnVsa0VtYWHlcIjp0sc2UsXCJDYW5jZWxXb3JrVGlja2V0XCI6dHJ1ZSxcIlNjaGVkdWxlQm9hcmRcIjp0cnVlLFwiU2NoZWR1bGVCb2FyZFJlYWRPbmx5XCI6dHJ1ZSxcIlJvdXRlT3B0aW1pemF0aW9uXCI6dHJ1ZSxcIlNjaGVkdWxlQW5FdmVudFwiOnRydWUsXCJBY2Nlc3NBdXRvVGltZUFjY2VwdGFuY2VSZXBvcnRzXCI6ZmFsc2UsXCJFZGl0Um91dGVzXCI6dHJ1ZSxcIkNyZXdMZWFkZXJcIjp0cnVlLFwiRXN0aW1hdGVcIjpmYWxzZSxcIlZpZXdBbGxUaW1lXCI6dHJ1ZSxcIk15UmVwb3J0c1wiOnRydWUsXCJBZHZhbmNlZFNlYXJjaFN5c3RlbUFkbWluXCI6ZmFsc2UsXCJIUkFkbWluXCI6dHJ1ZSxcIlNhbGVzTWFuYWdlclwiOnRydWUsXCJFZGl0UHJvcGVydHlCaWxsaW5nQ29udGFjdFwiOnRydWUsXCJVbmFwcHJvdmVSZWNlaXB0XCI6dHJ1ZSxcIkFwcHJvdmVUaW1lXCI6dHJ1ZSxcIkV4cG9ydFRpbWVcIjp0cnVlLFwiRWRpdFByaWNpbmdcIjp0cnVlLFwiQ2hvb3NlUmVwb3J0RXhwb3J0VHlwZVwiOnRydWUsXCJFZGl0QnVkZ2V0XCI6dHJ1ZSxcIlVuYXBwcm92ZVRpbWVcIjp0cnVlLFwiVmlld1JlYWRPbmx5UGF5cm9sbERhdGFcIjp0cnVlLFwiSW5vdmFMYWJvckJ1cmRlblRydWVVcFwiOnRydWUsXCJDcmVhdGVPdmVyVW5kZXJBZGp1c3RtZW50UmVjb3Jkc1wiOnRydWUsXCJDcmVhdGVSZWNlaXB0XCI6dHJ1ZSxcIkFwcHJvdmVSZWNlaXB0XCI6dHJ1ZSxcIkRlbGV0ZVJlY2VpcHRcIjp0cnVlLFwiQWRkUHVyY2hhc2VDcmVkaXRcIjp0cnVlLFwiU3VibWl0UmVjZWlwdFRvTGFuZHNjYXBlSHViXCI6dHJ1ZSxcIkFsbG93RXN0aW1hdGVOZWdhdGl2ZVF1YW50aXR5XCI6dHJ1ZSxcIkNyZWF0ZUludm9pY2VcIjp0cnVlLFwiVmlld0ludm9pY2luZ1wiOnRydWUsXCJFZGl0SW52b2ljaW5nXCI6dHJ1ZSxcIkRlbGV0ZUludm9pY2luZ1wiOnRydWUsXCJDcmVhdGVNaXNjSW52b2ljZVwiOmZhbHNlLFwiVmlld0FSTWFuYWdlbWVudFwiOnRydWUsXCJFZGl0QmlsbGluZ1wiOnRydWUsXCJWaWV3UHVyY2hhc2luZ1wiOnRydWUsXCJWaWV3UmV2ZW51ZVwiOnRydWUsXCJWaWV3UmVwb3J0c1wiOnRydWUsXCJDb21wbGV0ZVdvcmtUaWNrZXRcIjp0cnVlLFwiQXBwcm92ZVdvcmtUaWNrZXRcIjp0cnVlLFwiRGVsZXRlV29ya1RpY2tldFwiOnRydWUsXCJTd2FwQXNOZWVkZWRTZXJ2aWNlc1wiOnRydWUsXCJQYXJ0aWFsT2NjdXJcIjp0cnVlLFwiTW92ZVdvcmtUaWNrZXRDb3N0c1wiOnRydWUsXCJWaWV3T3Bwb3J0dW5pdGllc1wiOnRydWUsXCJWaWV3TXlPcHBvcnR1bml0aWVzXCI6ZmFsc2UsXCJXaW5Db250cmFjdFwiOnRydWUsXCJXaW5Xb3JrT3JkZXJcIjp0cnVlLFwiTG9zZU9wcG9ydHVuaXRpZXNcIjp0cnVlLFwiQWRkQ3JlZGl0TWVtb1wiOnRydWUsXCJUaWNrZXRCdWxrRW1haWxcIjp0cnVlLFwiRWRpdEJ1ZGdldGVkSG91ckFuZFJldmVudWVcIjp0cnVlLFwiUmVwb3J0QWNjZXNzXCI6e30sXCJNb2RpZnlTZW50SW52b2ljZXNcIjp0cnVlLFwiQWRkQ3Jld0xlYWRlckNvbnRhY3RcIjp0cnVlLFwiT3ZlcnJpZGVUb3RhbENvc3RcIjp0cnVlLFwiRWRpdEVhcm5lZFJldmVudWVcIjp0cnVlLFwiVmlld0tQSU92ZXJoZWFkUmVjb3ZlcnlcIjp0cnVlLFwiVmlld0tQSUNsaWVudE1hbmFnZW1lbnRcIjp0cnVlLFwiVmlld0tQSVByb2ZpdExvc3NcIjp0cnVlLFwiVmlld0tQSUZvcmVjYXN0XCI6dHJ1ZSxcIlZpZXdLUElDb21wbGV0ZWRMYWJvckVmZmljaWVuY3lcIjp0cnVlLFwiVmlld0tQSVNhbGVzU2NvcmVDYXJkXCI6dHJ1ZSxcIlZpZXdTYWxlc1BpcGVsaW5lSW5zaWdodFwiOnRydWUsXCJWaWV3Q3VzdG9tZXJJc3N1ZXNJbnNpZ2h0XCI6dHJ1ZSxcIkNsb3NlTW9udGhcIjp0cnVlLFwiQXBwcm92ZUVxdWlwbWVudFwiOnRydWUsXCJEaXNwb3NlRXF1aXBtZW50XCI6dHJ1ZSxcIkRlbGV0ZUVxdWlwbWVudFwiOnRydWUsXCJFcXVpcG1lbnRBZG1pblwiOnRydWUsXCJNYXJrRXF1aXBtZW50SW5TZXJ2aWNlXCI6dHJ1ZSxcIk1hcmtFcXVpcG1lbnRPdXRPZlNlcnZpY2VcIjp0cnVlLFwiUHVyY2hhc2VFcXVpcG1lbnRcIjp0cnVlLFwiUmVxdWVzdEVxdWlwbWVudFwiOnRydWUsXCJWaWV3RXF1aXBtZW50XCI6dHJ1ZSxcIkVzdGltYXRlQ3VzdG9tQ29sdW1uXCI6dHJ1ZSxcIlRyaWdnZXJBdXRvRXhwZW5zZUNyZWF0aW9uXCI6dHJ1ZSxcIlJvdXRlU2NoZWR1bGluZ1wiOnRydWUsXCJBZGRGdWVsUmF0ZVwiOnRydWUsXCJGdWVsQ29zdFJlcG9ydFwiOnRydWUsXCJNYW5hZ2VDdXN0b21GaWVsZHNcIjp0cnVlLFwiUHJvY2Vzc0VsZWN0cm9uaWNQYXltZW50c1wiOnRydWUsXCJWb2lkRWxlY3Ryb25pY1BheW1lbnRzXCI6dHJ1ZSxcIlJlZnVuZEVsZWN0cm9uaWNQYXltZW50c1wiOnRydWUsXCJFeHBpcmluZ0VsZWN0cm9uaWNQYXltZW50TWV0aG9kc0FsZXJ0c1wiOnRydWUsXCJSZWplY3RlZEVsZWN0cm9uaWNQYXltZW50c0FsZXJ0c1wiOnRydWUsXCJBbm51YWxSZW5ld2Fsc1wiOnRydWUsXCJWaWV3Q29tcGFuaWVzXCI6dHJ1ZSxcIkVkaXRDb21wYW5pZXNcIjp0cnVlLFwiQWRkQ29tcGFuaWVzXCI6dHJ1ZSxcIkNhbmNlbENvbnRyYWN0XCI6dHJ1ZSxcIkNhbmNlbFdvcmtPcmRlclwiOnRydWUsXCJNb2RpZnlTT1ZBZnRlck9wcG9ydHVuaXR5SXNXb25cIjp0cnVlLFwiQ2hhbmdlQXNzaWduZWRQcm9wZXJ0eUJyYW5jaFwiOnRydWUsXCJNYW5hZ2VVc2VyUm9sZXNcIjp0cnVlLFwiRWRpdEVxdWlwbWVudENvc3RBbmRIb3Vyc1wiOnRydWUsXCJDcmVhdGVFcXVpcG1lbnRJbnNwZWN0aW9uc1wiOnRydWUsXCJSZWNlaXZlUmVjZWlwdFwiOnRydWUsXCJNYW5hZ2VOb3RpZmljYXRpb25zU3lzdGVtXCI6dHJ1ZSxcIk1hbmFnZU5vdGlmaWNhdGlvbnNCcmFuY2hcIjp0cnVlLFwiUmVwb3J0V2ViRGVzaWduZXJcIjp0cnVlLFwiVmlld0ludmVudG9yeUxvY2F0aW9uc1wiOnRydWUsXCJFZGl0SW52ZW50b3J5TG9jYXRpb25zXCI6dHJ1ZSxcIlJvbGVQZXJtaXNzaW9uXCI6W10sXCJMb2NhbEJyYW5jaEFkbWluXCI6ZmFsc2UsXCJIYXNBbnlSZXBvcnRBY2Nlc3NcIjpmYWxzZX0iLCJBc3BpcmVTeXN0ZW1TZXR0aW5ncyI6IntcIkNvbXBhbnlOYW1lXCI6XCJJbmNyZWRpc2NhcGUgVUFUXCIsXCJFc3RpbWF0ZUxpY2Vuc2VcIjp0cnVlLFwiVGlja2V0TWFuYWdlbWVudExpY2Vuc2VcIjp0cnVlLFwiRXN0aW1hdGluZ1N0YWdpbmdcIjpmYWxzZSxcIkludm9pY2luZ0xpY2Vuc2VcIjp0cnVlLFwiQVJNYW5hZ2VtZW50TGljZW5zZVwiOnRydWUsXCJCaWxsaW5nRW1haWxGcm9tQWNjb3VudE93bmVyXCI6ZmFsc2UsXCJQYXljaGV4SW5jbHVkZURhdGVzXCI6dHJ1ZSxcIlJlcXVpcmVVbmlxdWVWZW5kb3JJbnZvaWNlTnVtYmVyXCI6ZmFsc2UsXCJSZXN0cmljdEVkaXRpbmdFbXBsb3llZXNcIjpmYWxzZSxcIkNyZWF0ZVByb3BlcnR5RnJvbUNvbnRhY3RcIjp0cnVlLFwiRW5hYmxlRWxlY3Ryb25pY1NpZ25hdHVyZXNcIjp0cnVlLFwiTWFzdGVyU3lzdGVtXCI6ZmFsc2UsXCJTbm93TW9kZVwiOnRydWUsXCJPcHBvcnR1bml0eUJyYW5jaE92ZXJyaWRlXCI6dHJ1ZSxcIlJvdW5kQ2xvY2tJbk91dFRpbWVzXCI6ZmFsc2UsXCJPTEFQUGl2b3RFbmFibGVkXCI6dHJ1ZSxcIkRpc2FibGVBdXRvbWF0aWNBcHByb3ZhbFwiOnRydWUsXCJEaXNhYmxlTW9iaWxlQ3Jld01hbmFnZW1lbnRcIjpmYWxzZSxcIkRpc2FibGVEZWxldGlvbk9mV29ya1RpY2tldHNcIjpmYWxzZSxcIkFsbG93U3ViVG9Mb2dpblwiOnRydWUsXCJIaWRlU2NoZWR1bGVQcm9ncmVzc0JhclwiOmZhbHNlLFwiV2Fybk9uRWFybHlMdW5jaENsb2NraW5cIjoyLFwiQ2FsaWZvcm5pYVRpbWVQcm9tcHRzXCI6ZmFsc2UsXCJJbnZvaWNpbmdBc3Npc3RhbnRSZXF1aXJlQmlsbGluZ0NvbXBhbnlcIjpmYWxzZSxcIkVuZm9yY2VCcmFuY2hBZG1pbkFkbWluaXN0cmF0aW9uU2VjdXJpdHlcIjp0cnVlLFwiT1RDYWxjdWxhdGlvblwiOlwiT3ZlcnJpZGUgUGF5Y29kZVwiLFwiRXF1aXBtZW50UmVhZGluZ0Nsb2NrT3V0UHJvbXB0XCI6XCJFbmQgb2YgRGF5XCIsXCJTaG93TmV0R3Jvc3NNYXJnaW5PbkVzdGltYXRpbmdTY3JlZW5cIjp0cnVlLFwiU2hvd09ubHlHcm9zc01hcmdpbm9uRXN0aW1hdGluZ1NjcmVlblwiOmZhbHNlLFwiQ3JlYXRlRXF1aXBtZW50UmVhZGluZ3NcIjp0cnVlLFwiSW5jbHVkZURyaXZlVGltZVdoZW5Mb2dnaW5nRXF1aXBtZW50Q3Jld01vYmlsZVwiOnRydWUsXCJFbmFibGVOZWdhdGl2ZUNoYW5nZU9yZGVyc1wiOnRydWUsXCJFbmFibGVDdXN0b21lclBvcnRhbFwiOnRydWUsXCJEZWZhdWx0R0VPUGVyaW1ldGVyXCI6NTAwLjAsXCJFbmFibGVBc3BpcmVHUFNJbnRlZ3JhdGlvblwiOnRydWUsXCJFbmFibGVFcXVpcG1lbnRNb2R1bGVBZGRPblwiOnRydWUsXCJHUFNJbnRlZ3JhdGlvblByb3ZpZGVyXCI6MyxcIkVuYWJsZUVsZWN0cm9uaWNQYXltZW50c1wiOnRydWUsXCJFbmFibGVTaXRlT25lXCI6ZmFsc2UsXCJCcmVha1RpbWVcIjowLjUsXCJQYXljaGV4RXhwb3J0Rm9ybWF0XCI6XCJEZWZhdWx0IENTVlwiLFwiRW5hYmxlUGFydGlhbFRpbWVPblN1YlBvcnRhbFwiOnRydWUsXCJFbmFibGVQYXJ0aWFsVGltZU9uQ3Jld01vYmlsZVwiOnRydWUsXCJFbmFibGVMYW5kc2NhcGVIdWJJbnRlZ3JhdGlvblwiOnRydWUsXCJEaXNwbGF5VGF4T25Fc3RpbWF0ZVwiOnRydWUsXCJMaW5rU2NoZWR1bGVvZlZhbHVldG9TZXJ2aWNlQnlEZWZhdWx0XCI6ZmFsc2UsXCJFbmFibGVXZWF0aGVZXF1aXJlTm9PcGVuSW52b2ljZXNDaGVja1wiOnRydWUsXCJQcm9kdWN0VGllclwiOjAsXCJDYW5BY2Nlc3NBUElzXCI6ZmFsc2UsXCJIYXNGYWNpYWxSZWNcIjpmYWxzZSxcIkVuYWJsZVRha2VvZmZJbnRlZ3JhdGlvblwiOnRydWUsXCJUYWtlb2ZmSW50ZWdyYXRpb25UeXBlXCI6NyxcIkRlZmF1bHRQcm9wZXJ0eVRha2VvZmZQcm92aWRlclwiOjQsXCJEZWZhdWx0RXN0aW1hdGVUYWtlb2ZmUHJvdmlkZXJcIjo0LFwiRW5hYmxlV2ViUmVwb3J0RGVzaWduZXJcIjpmYWxzZSxcIkF6dWdhQ3VzdG9tZXJJRFwiOjEwNTksXCJFbmFibGVDcmV3TWVtYmVyQ2xvY2tJbldpdGhvdXRDcmV3TGVhZGVyXCI6ZmFsc2UsXCJFbmFibGVFT01SZXBvcnRcIjpmYWxzZSxcIlVzZU9wcG9ydHVuaXR5SXRlbURpc3BsYXlOYW1lT25JbnZvaWNlXCI6dHJ1ZSxcIkVuYWJsZVZpc2l0Q2hlY2tsaXN0c1wiOnRydWUsXCJUaW1lWm9uZVwiOlwiQW1lcmljYS9DaGljYWdvXCIsXCJGaXJzdERheU9mV2Vla1wiOlwiTW9uZGF5XCIsXCJJbm92YUVuYWJsZWRcIjp0cnVlLFwiUFRPVmlzaWJsZVwiOnRydWUsXCJNYXJrZXRpbmdQcm9JbnRlZ3JhdGlvblwiOmZhbHNlLFwiTWFya2V0aW5nUHJvVmVyc2lvblwiOm5WluVHlwZVwiOjB9IiwiRm9yYmlkZGVuIjoiIiwibmJmIjoxNzA0Njg0Njc2LCJleHAiOjE3MDQ3NzEwNzYsImlhdCI6MTcwNDY4NDY3Nn0.FALf4zF0kIAf-pZPVmj8wChCDxGRaVuxQPHrzUy-Df0")
--header ("accept", "application/json;odata.metadata=minimal;odata.streaming=true, application/json;odata.metadata=minimal;odata.streaming=false, application/json;odata.metadata=minimal, application/json;odata.metadata=full;odata.streaming=true, application/json;odata.metadata=full;odata.streaming=false, application/json;odata.metadata=full, application/json;odata.metadata=none;odata.streaming=true, application/json;odata.metadata=none;odata.streaming=false, application/json;odata.metadata=none, application/json;odata.streaming=true, application/json;odata.streaming=false, application/json, application/xml, application/prs.odatatestxx-odata, text/plain, text/json")
ge (greater than or equal to)
Value is greater than or equal to the value you selected to filter.
Example | |
Desired outcome | Retrieve a list of only opportunities with a Won Date greater or equal to 12/26/2023. |
Base URL | https://cloud-api.youraspire.com |
Resource | Opportunities |
Query Parameter | $filter |
Filter option | WonDate ge 2023-12-26 |
Query | https://cloud-api.youraspire.com?$filter=WonDate ge 2023-12-26 |
Example Response
[
{
"OpportunityID": 26382,
"PropertyID": 34246,
"OpportunityStatusID": 122,
"OpportunityStatusName": "1.Won",
"SalesRepContactID": 22596,
"SalesRepContactName": "Joe Barry",
"OperationsManagerContactID": null,
"OperationsManagerContactName": null,
"DivisionID": 90,
"DivisionName": "Enhancement",
"BranchID": 50,
"BranchName": "St. Louis",
"SalesTypeID": 29,
"SalesTypeName": "New Sale",
"TemplateOpportunityID": null,
"LeadSourceID": null,
"LeadSourceName": null,
"MasterOpportunityID": null,
"BillingAddressID": 39552,
"BillingAddressLine1": "6744 S Maple Court",
"BillingAddressLine2": null,
"BillingAddressCity": "Chancy",
"BillingAddressStateProvinceCode": "MO",
"BillingAddressZipCode": "63351",
"OpportunityType": "Work Order",
"MasterSequenceNum": null,
"OpportunityName": "An Opportunity",
"ProposalDescription1": null,
"StartDate": "2024-01-01T00:00:00Z",
"EndDate": "2024-01-31T00:00:00Z",
"BidDueDate": null,
"CreatedDateTime": "2019-02-01T20:36:00.787Z",
"ApprovedDate": "2024-01-03T12:07:46.903Z",
"ProposedDate": "2024-01-03T12:07:59.883Z",
"WonDate": "2024-01-03T12:08:55.357Z",
"LostDate": null,
"Probability": 100,
"AnticipatedCloseDate": null,
"InvoiceType": "Fixed Price on Completion",
"CustomerContractNum": null,
"CustomerPONum": null,
"BudgetedDollars": 0,
"EstimatedDollars": 286.74,
"StateTaxPercent": 5.5,
"FederalTaxPercent": 0,
"CreatedByUserID": 3317,
"CreatedByUserName": "Joe Barry",
"ApprovedUserID": 3643,
"ApprovedUserName": "A Name",
"ProposedUserID": 3643,
"ProposedUserName": A Name",
}
]
Code Sample
curl --request GET \
--url ("https://cloud-api.youraspire.com/Opportunities?%24filter=WonDate%20ge%202023-12-26")
--header ("Authorization", "eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJBc3BpcmVTeXN0ZW1JRCI6IjE1IiwiVXNlcklEIjoiNDg0OCIsIlVzZXJQZXJtaXNzaW9ucyI6IntcIlJvbGVJRFwiOjAsXCJSb2xlTmFtZVwiOm51bGwsXCJSZXF1aXJlZFwiOmZhbHNlLFwiUm9sZVZhbHVlXCI6MSxcIkFkZENvbnRhY3RcIjp0cnVlLFwiRWRpdE15Q29udGFjdHNcIjp0cnVlLFwiRWRpdEFsbENvbnRhY3RzXCI6dHJ1ZSxcIkRlbGV0ZUNvbnRhY3RcIjpmYWxzZSxcIkFkZEVtcGxveWVlSW5jaWRlbnRcIjp0cnVlLFwiRWRpdEFjY291bnRpbmdTeW5jSURcIjp0cnVlLFwiQnVsa0VtYWlsQ29udGFjdHNcIjp0cnVlLFwiU2VuZEN1c3RvbWVyUG9ydGFsSW52aXRhdGlvblwiOnRydWUsXCJJbXBvcnRDb250YWN0QW5kUHJvcGVydHlcIjp0cnVlLFwiQ29uZmlndXJlQ29udGFjdFJlcXVpcmVkRmllbGRzXCI6dHJ1ZSxcIkRlbGV0ZU1lcmdlQ29udGFjdHNcIjp0cnVlLFwiVXBkYXRlRW1wbG95ZWVQSU5cIjpmYWxzZSxcIkFkZFByb3BlcnR5XCI6dHJ1ZSxcIkVkaXRNeVByb3BlcnRpZXNcIjp0cnVlLFwiRWRpdEFsbFByb3BlcnRpZXNcIjp0cnVlLFwiRGVsZXRlUHJvcGVydHlcIjpmYWxzZSxcIkVkaXRRdWFsaXR5QXVkaXRzXCI6dHJ1ZSxcIlZpZXdQcm9wZXJ0aWVzXCI6dHJ1ZSxcIlZpZXdNeVByb3BlcnRpZXNcIjpmYWxzZSxcIkFkZE9wcG9ydHVuaXR5XCI6dHJ1ZSxcIkVkaXRNeU9wcG9ydHVuaXRpZXNcIjp0cnVlLFwiRWRpdEFsbE9wcG9ydHVuaXRpZXNcIjp0cnVlLFwiRGVsZXRlT3Bwb3J0dW5pdHlcIjp0cnVlLFwiQ2hhbmdlT3Bwb3J0dW5pdHlcIjp0cnVlLFwiVmlld1JlYWRPbmx5RXN0aW1hdGVzXCI6dHJ1ZSxcIlVuY2FuY2VsT3Bwb3J0dW5pdHlcIjp0cnVlLFwiSm9iRGFzaGJvYXJkXCI6dHJ1ZSxcIkltcG9ydEVzdGltYXRlXCI6dHJ1ZSxcIkVkaXRTZXJ2aWNlUGF5Q29kZXNcIjp0cnVlLFwiRGVsZXRlQWN0aXZpdHlcIjp0cnVlLFwiU3lzdGVtQWRtaW5cIjp0cnVlLFwiQnJhbmNoQWRtaW5cIjpmYWxzZSxcIlZpZXdSb3V0ZXNcIjp0cnVlLFwiTWFuYWdlT3Bwb3J0dW5pdHlUZW1wbGF0ZXNcIjp0cnVlLFwiTWFuYWdlR2VuZXJhbENvbmRpdGlvblRlbXBsYXRlc1wiOnRydWUsXCJNYWtlVmlzaXRDaGVja2xpc3RJdGVtc01hbmRhdG9yeVwiOnRydWUsXCJFZGl0RGFpbHlQbGFuUmVwb3J0XCI6dHJ1ZSxcIk1hcmtldGluZ1Byb1wiOnRydWUsXCJFeHBvcnRHcmlkc1wiOnRydWUsXCJFZGl0VGVtcGxhdGVzXCI6dHJ1ZSxcIk1hbmFnZVRlbXBsYXRlc1wiOnRydWUsXCJFZGl0RXN0aW1hdGVQcmljaW5nUGN0XCI6dHJ1ZSxcIkVkaXRFc3RpbWF0ZUl0ZW1zXCI6dHJ1ZSxcIkhvdXJSZWR1Y3Rpb25QY3RcIjoxMDAuMCxcIlByaWNlUmVkdWN0aW9uUGN0XCI6MTAwLjAsXCJVbmJhbGFuY2VkUGF5bWVudFNjaGVkdWxlXCI6dHJ1ZSxcIkFsbG93T25lVGltZUl0ZW1zXCI6dHJ1ZSxcIkFkZEl0ZW1zVG9DYXRhbG9nXCI6dHJ1ZSxcIkNoYW5nZVNlcnZpY2VJbnZvaWNlVHlwZU9uRml4ZWRQcmljZU9wZW5CaWxsaW5nXCI6dHJ1ZSxcIkFkanVzdEdlbmVyYWxDb25kaXRpb25zXCI6dHJ1ZSxcIkFkZE1vZGlmeVBheWNvZGVPdmVycmlkZXNcIjp0cnVlLFwiQXNOZWVkZWRFeGNlcHRpb25SZXBvcnRcIjp0cnVlLFwiTWFrZU9wcG9ydHVuaXR5U2VydmljZVZpc2l0Q2hlY2tsaXN0SXRlbXNNYW5kYXRvcnlcIjp0cnVlLFwiUHJvZHVjdGlvblwiOmZhbHNlLFwiVXBkYXRlSm9iXCI6ZmFsc2UsXCJDYW5jZWxXb3JrVGlja2V0XCI6dHJ1ZSxcIlNjaGVkdWxlQm9hcmRcIjp0cnVlLFwiU2NoZWR1bGVCb2FyZFJlYWRPbmx5XCI6dHJ1ZSxcIlJvdXRlT3B0aW1pemF0aW9uXCI6dHJ1ZSxcIlNjaGVkdWxlQW5FdmVudFwiOnRydWUsXCJBY2Nlc3NBdXRvVGltZUFjY2VwdGFuY2VSZXBvcnRzXCI6ZmFsc2UsXCJFZGl0Um91dGVzXCI6dHJ1ZSxcIkNyZXdMZWFkZXJcIjp0cnVlLFwiRXN0aW1hdGVcIjpmYWxzZSxcIlZpZXdBbGxUaW1lXCI6dHJ1ZSxcIk15UmVwb3J0c1wiOnRydWUsXCJBZHZhbmNlZFNlYXJjaFN5c3RlbUFkbWluXCI6ZmFsc2UsXCJIUkFkbWluXCI6dHJ1ZSxcIlNhbGVzTWFuYWdlclwiOnRydWUsXCJFZGl0UHJvcGVydHlCaWxsaW5nQ29udGFjdFwiOnRydWUsXCJVbmFwcHJvdmVSZWNlaXB0XCI6dHJ1ZSxcIkFwcHJvdmVUaW1lXCI6dHJ1ZSxcIkV4cG9ydFRpbWVcIjp0cnVlLFwiRWRpdFByaWNpbmdcIjp0cnVlLFwiQ2hvb3NlUmVwb3J0RXhwb3J0VHlwZVwiOnRydWUsXCJFZGl0QnVkZ2V0XCI6dHJ1ZSxcIlVuYXBwcm92ZVRpbWVcIjp0cnVlLFwiVmlld1JlYWRPbmx5UGF5cm9sbERhdGFcIjp0cnVlLFwiSW5vdmFMYWJvckJ1cmRlblRydWVVcFwiOnRydWUsXCJDcmVhdGVPdmVyVW5kZXJBZGp1c3RtZW50UmVjb3Jkc1wiOnRydWUsXCJDcmVhdGVSZWNlaXB0XCI6dHJ1ZSxcIkFwcHJvdmVSZWNlaXB0XCI6dHJ1ZSxcIkRlbGV0ZVJlY2VpcHRcIjp0cnVlLFwiQWRkUHVyY2hhc2VDcmVkaXRcIjp0cnVlLFwiU3VibWl0UmVjZWlwdFRvTGFuZHNjYXBlSHViXCI6dHJ1ZSxcIkFsbG93RXN0aW1hdGVOZWdhdGl2ZVF1YW50aXR5XCI6dHJ1ZSxcIkNyZWF0ZUludm9pY2VcIjp0cnVlLFwiVmlld0ludm9pY2luZ1wiOnRydWUsXCJFZGl0SW52b2ljaW5nXCI6dHJ1ZSxcIkRlbGV0ZUludm9pY2luZ1wiOnRydWUsXCJDcmVhdGVNaXNjSW52b2ljZVwiOmZhbHNlLFwiVmlld0FSTWFuYWdlbWVudFwiOnRydWUsXCJFZGl0QmlsbGluZ1wiOnRydWUsXCJWaWV3UHVyY2hhc2luZ1wiOnRydWUsXCJWaWV3UmV2ZW51ZVwiOnRydWUsXCJWaWV3UmVwb3J0c1wiOnRydWUsXCJDb21wbGV0ZVdvcmtUaWNrZXRcIjp0cnVlLFwiQXBwcm92ZVdvcmtUaWNrZXRcIjp0cnVlLFwiRGVsZXRlV29ya1RpY2tldFwiOnRydWUsXCJTd2FwQXNOZWVkZWRTZXJ2aWNlc1wiOnRydWUsXCJQYXJ0aWFsT2NjdXJcIjp0cnVlLFwiTW92ZVdvcmtUaWNrZXRDb3N0c1wiOnRydWUsXCJWaWV3T3Bwb3J0dW5pdGllc1wiOnRydWUsXCJWaWV3TXlPcHBvcnR1bml0aWVzXCI6ZmFsc2UsXCJXaW5Db250cmFjdFwiOnRydWUsXCJXaW5Xb3JrT3JkZXJcIjp0cnVlLFwiTG9zZU9wcG9ydHVuaXRpZXNcIjp0cnVlLFwiQWRkQ3JlZGl0TWVtb1wiOnRydWUsXCJUaWNrZXRCdWxrRW1haWxcIjp0cnVlLFwiRWRpdEJ1ZGdldGVkSG91ckFuZFJldmVudWVcIjp0cnVlLFwiUmVwb3J0QWNjZXNzXCI6e30sXCJNb2RpZnlTZW50SW52b2ljZXNcIjp0cnVlLFwiQWRkQ3Jld0xlYWRlckNvbnRhY3RcIjp0cnVlLFwiT3ZlcnJpZGVUb3RhbENvc3RcIjp0cnVlLFwiRWRpdEVhcm5lZFJldmVudWVcIjp0cnVlLFwiVmlld0tQSU92ZXJoZWFkUmVjb3ZlcnlcIjp0cnVlLFwiVmlld0tQSUNsaWVudE1hbmFnZW1lbnRcIjp0cnVlLFwiVmlld0tQSVByb2ZpdExvc3NcIjp0cnVlLFwiVmlld0tQSUZvcmVjYXN0XCI6dHJ1ZSxcIlZpZXdLUElDb21wbGV0ZWRMYWJvckVmZmljaWVuY3lcIjp0cnVlLFwiVmlld0tQSVNhbGVzU2NvcmVDYXJkXCI6dHJ1ZSxcIlZpZXdTYWxlc1BpcGVsaW5lSW5zaWdodFwiOnRydWUsXCJWaWV3Q3VzdG9tZXJJc3N1ZXNJbnNpZ2h0XCI6dHJ1ZSxcIkNsb3NlTW9udGhcIjp0cnVlLFwiQXBwcm92ZUVxdWlwbWVudFwiOnRydWUsXCJEaXNwb3NlRXF1aXBtZW50XCI6dHJ1ZSxcIkRlbGV0ZUVxdWlwbWVudFwiOnRydWUsXCJFcXVpcG1lbnRBZG1pblwiOnRydWUsXCJNYXJrRXF1aXBtZW50SW5TZXJ2aWNlXCI6dHJ1ZSxcIk1hcmtFcXVpcG1lbnRPdXRPZlNlcnZpY2VcIjp0cnVlLFwiUHVyY2hhc2VFcXVpcG1lbnRcIjp0cnVlLFwiUmVxdWVzdEVxdWlwbWVudFwiOnRydWUsXCJWaWV3RXF1aXBtZW50XCI6dHJ1ZSxcIkVzdGltYXRlQ3VzdG9tQ29sdW1uXCI6dHJ1ZSxcIlRyaWdnZXJBdXRvRXhwZW5zZUNyZWF0aW9uXCI6dHJ1ZSxcIlJvdXRlU2NoZWR1bGluZ1wiOnRydWUsXCJBZGRGdWVsUmF0ZVwiOnRydWUsXCJGdWVsQ29zdFJlcG9ydFwiOnRydWUsXCJNYW5hZ2VDdXN0b21GaWVsZHNcIjp0cnVlLFwiUHJvY2Vzc0VsZWN0cm9uaWNQYXltZW50c1wiOnRydWUsXCJWb2lkRWxlY3Ryb25pY1BheW1lbnRzXCI6dHJ1ZSxcIlJlZnVuZEVsZWN0cm9uaWNQYXltZW50c1wiOnRydWUsXCJFeHBpcmluZ0VsZWN0cm9uaWNQYXltZW50TWV0aG9kc0FsZXJ0c1wiOnRydWUsXCJSZWplY3RlZEVsZWN0cm9uaWNQYXltZW50c0FsZXJ0c1wiOnRydWUsXCJBbm51YWxSZW5ld2Fsc1wiOnRydWUsXCJWaWV3Q29tcGFuaWVzXCI6dHJ1ZSxcIkVkaXRDb21wYW5pZXNcIjp0cnVlLFwiQWRkQ29tcGFuaWVzXCI6dHJ1ZSxcIkNhbmNlbENvbnRyYWN0XCI6dHJ1ZSxcIkNhbmNlbFdvcmtPcmRlclwiOnRydWUsXCJNb2RpZnlTT1ZBZnRlck9wcG9ydHVuaXR5SXNXb25cIjp0cnVlLFwiQ2hhbmdlQXNzaWduZWRQcm9wZXJ0eUJyYW5jaFwiOnRydWUsXCJNYW5hZ2VVc2VyUm9sZXNcIjp0cnVlLFwiRWRpdEVxdWlwbWVudENvc3RBbmRIb3Vyc1wiOnRydWUsXCJDcmVhdGVFcXVpcG1lbnRJbnNwZWN0aW9uc1wiOnRydWUsXCJSZWNlaXZlUmVjZWlwdFwiOnRydWUsXCJNYW5hZ2VOb3RpZmljYXRpb25zU3lzdGVtXCI6dHJ1ZSxcIk1hbmFnZU5vdGlmaWNhdGlvbnNCcmFuY2hcIjp0cnVlLFwiUmVwb3J0V2ViRGVzaWduZXJcIjp0cnVlLFwiVmlld0ludmVudG9yeUxvY2F0aW9uc1wiOnRydWUsXCJFZGl0SW52ZW50b3J5TG9jYXRpb25zXCI6dHJ1ZSxcIlJvZmFsc2UsXCJFbmFibGVFT01SZXBvcnRcIjpmYWxzZSxcIlVzZU9wcG9ydHVuaXR5SXRlbURpc3BsYXlOYW1lT25JbnZvaWNlXCI6dHJ1ZSxcIkVuYWJsZVZpc2l0Q2hlY2tsaXN0c1wiOnRydWUsXCJUaW1lWm9uZVwiOlwiQW1lcmljYS9DaGljYWdvXCIsXCJGaXJzdERheU9mV2Vla1wiOlwiTW9uZGF5XCIsXCJJbm92YUVuYWJsZWRcIjp0cnVlLFwiUFRPVmlzaWJsZVwiOnRydWUsXCJNYXJrZXRpbmdQcm9JbnRlZ3JhdGlvblwiOmZhbHNlLNzA0Njg0Njc2LCJleHAiOjE3MDQ3NzEwNzYsImlhdCI6MTcwNDY4NDY3Nn0.FALf4zF0kIAf-pZPVmj8wChCDxGRaVuxQPHrzUy-Df0")
--header ("accept", "application/json;odata.metadata=minimal;odata.streaming=true, application/json;odata.metadata=minimal;odata.streaming=false, application/json;odata.metadata=minimal, application/json;odata.metadata=full;odata.streaming=true, application/json;odata.metadata=full;odata.streaming=false, application/json;odata.metadata=full, application/json;odata.metadata=none;odata.streaming=true, application/json;odata.metadata=none;odata.streaming=false, application/json;odata.metadata=none, application/json;odata.streaming=true, application/json;odata.streaming=false, application/json, application/xml, application/prs.odatatestxx-odata, text/plain, text/json")
lt (less than)
The value is less than.
Example | |
Desired outcome | Only return bank deposits with a deposit amount that is less than $1000.00. |
Base URL | https://cloud-api.youraspire.com |
Resource | Bank Deposits |
Query Parameter | $filter |
Filter option | DepositAmount lt 1000.00 |
Query | https://cloud-api.youraspire.com?$filter=DepositAmount lt 1000.00 |
Example Response
[
{
"BankDepositID": 2086,
"BranchID": null,
"BranchName": null,
"DepositDate": "2017-04-28T00:00:00Z",
"DepositAmount": 287.3,
"DepositStatus": "Sent",
"CreatedDateTime": "2017-04-28T12:53:37.53Z",
"CreatedByUserID": 3317,
"CreatedByUserName": "Joe Barry",
"DateSentToAccounting": "2019-02-04T17:08:19.57Z",
"SentToAccountingUserID": 3317,
"SentToAccountingUserName": "Joe Barry",
"AccountingMessage": null,
"ResetToNewDate": null,
"ResetToNewUserID": null,
"ResetToNewUserName": null
}
]
Code Sample
curl --request GET \
--url ("https:///cloud-api.youraspire.com/BankDeposits?%24filter=DepositAmount%20lt%201000.00")
--header ("Authorization", "eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJBc3BpcmVTeXN0ZW1JRCI6IjE1IiwiVXNlcklEIjoiNDg0OCIsIlVzZXJQZXJtaXNzaW9ucyI6IntcIlJvbGVJRFwiOjAsXCJSb2xlTmFtZVwiOm51bGwsXCJSZXF1aXJlZFwiOmZhbHNlLFwiUm9sZVZhbHVlXCI6MSxcIkFkZENvbnRhY3RcIjp0cnVlLFwiRWRpdE15Q29udGFjdHNcIjp0cnVlLFwiRWRpdEFsbENvbnRhY3RzXCI6dHJ1ZSxcIkRlbGV0ZU1lcmdlQ29udGFjdHNcIjp0cnVlLFwiVXBkYXRlRW1wbG95ZWVQSU5cIjpmYWxzZSxcIkFkZFByb3BlcnR5XCI6dHJ1ZSxcIkVkaXRNeVByb3BlcnRpZXNcIjp0cnVlLFwiRWRpdEFsbFByb3BlcnRpZXNcIjp0cnVlLFwiRGVsZXRlUHJvcGVydHlcIjpmYWxzZSxcIkVkaXRRdWFsaXR5QXVkaXRzXCI6dHJ1ZSxcIlZpZXdQcm9wZXJ0aWVzXCI6dHJ1ZSxcIlZpZXdNeVByb3BlcnRpZXNcIjpmYWxzZSxcIkFkZE9wcG9ydHVuaXR5XCI6dHJ1ZSxcIkVkaXRNeU9wcG9ydHVuaXRpZXNcIjp0cnVlLFwiRWRpdEFsbE9wcG9ydHVuaXRpZXNcIjp0cnVlLFwiRGVsZXRlT3Bwb3J0dW5pdHlcIjp0cnVlLFwiQ2hhbmdlT3Bwb3J0dW5pdHlcIjp0cnVlLFwiVmlld1JlYWRPbmx5RXN0aW1hdGVzXCI6dHJ1ZSxcIlVuY2FuY2VsT3Bwb3J0dW5pdHlcIjp0cnVlLFwiSm9iRGFzaGJvYXJkXCI6dHJ1ZSxcIkltcG9ydEVzdGltYXRlXCI6dHJ1ZSxcIkVkaXRTZXJ2aWNlUGF5Q29kZXNcIjp0cnVlLFwiRGVsZXRlQWN0aXZpdHlcIjp0cnVlLFwiU3lzdGVtQWRtaW5cIjp0cnVlLFwiQnJhbmNoQWRtaW5cIjpmYWxzZSxcIlZpZXdSb3V0ZXNcIjp0cnVlLFwiTWFuYWdlT3Bwb3J0dW5pdHlUZW1wbGF0ZXNcIjp0cnVlLFwiTWFuYWdlR2VuZXJhbENvbmRpdGlvblRlbXBsYXRlc1wiOnRydWUsXCJNYWtlVmlzaXRDaGVja2xpc3RJdGVtc01hbmRhdG9yeVwiOnRydWUsXCJFZGl0RGFpbHlQbGFuUmVwb3J0XCI6dHJ1ZSxcIk1hcmtldGluZ1Byb1wiOnRydWUsXCJFeHBvcnRHcmlkc1wiOnRydWUsXCJFZGl0VGVtcGxhdGVzXCI6dHJ1ZSxcIk1hbmFnZVRlbXBsYXRlc1wiOnRydWUsXCJFZGl0RXN0aW1hdGVQcmljaW5nUGN0XCI6dHJ1ZSxcIkVkaXRFc3RpbWF0ZUl0ZW1zXCI6dHJ1ZSxcIkhvdXJSZWR1Y3Rpb25QY3RcIjoxMDAuMCxcIlByaWNlUmVkdWN0aW9uUGN0XCI6MTAwLjAsXCJVbmJhbGFuY2VkUGF5bWVudFNjaGVkdWxlXCI6dHJ1ZSxcIkFsbG93T25lVGltZUl0ZW1zXCI6dHJ1ZSxcIkFkZEl0ZW1zVG9DYXRhbG9nXCI6dHJ1ZSxcIkNoYW5nZVNlcnZpY2VJbnZvaWNlVHlwZU9uRml4ZWRQcmljZU9wZW5CaWxsaW5nXCI6dHJ1ZSxcIkFkanVzdEdlbmVyYWxDb25kaXRpb25zXCI6dHJ1ZSxcIkFkZE1vZGlmeVBheWNvZGVPdmVycmlkZXNcIjp0cnVlLFwiQXNOZWVkZWRFeGNlcHRpb25SZXBvcnRcIjp0cnVlLFwiTWFrZU9wcG9ydHVuaXR5U2VydmljZVZpc2l0Q2hlY2tsaXN0SXRlbXNNYW5kYXRvcnlcIjp0cnVlLFwiUHJvZHVjdGlvblwiOmZhbHNlLFwiVXBkYXRlSm9iXCI6ZmFsc2UsXCJDYW5jZWxXb3JrVGlja2V0XCI6dHJ1ZSxcIlNjaGVkdWxlQm9hcmRcIjp0cnVlLFwiU2NoZWR1bGVCb2FyZFJlYWRPbmx5XCI6dHJ1ZSxcIlJvdXRlT3B0aW1pemF0aW9uXCI6dHJ1ZSxcIlNjaGVkdWxlQW5FdmVudFwiOnRydWUsXCJBY2Nlc3NBdXRvVGltZUFjY2VwdGFuY2VSZXBvcnRzXCI6ZmFsc2UsXCJFZGl0Um91dGVzXCI6dHJ1ZSxcIkNyZXdMZWFkZXJcIjp0cnVlLFwiRXN0aW1hdGVcIjpmYWxzZSxcIlZpZXdBbGxUaW1lXCI6dHJ1ZSxcIk15UmVwb3J0c1wiOnRydWUsXCJBZHZhbmNlZFNlYXJjaFN5c3RlbUFkbWluXCI6ZmFsc2UsXCJIUkFkbWluXCI6dHJ1ZSxcIlNhbGVzTWFuYWdlclwiOnRydWUsXCJFZGl0UHJvcGVydHlCaWxsaW5nQ29udGFjdFwiOnRydWUsXCJVbmFwcHJvdmVSZWNlaXB0XCI6dHJ1ZSxcIkFwcHJvdmVUaW1lXCI6dHJ1ZSxcIkV4cG9ydFRpbWVcIjp0cnVlLFwiRWRpdFByaWNpbmdcIjp0cnVlLFwiQ2hvb3NlUmVwb3J0RXhwb3J0VHlwZVwiOnRydWUsXCJFZGl0QnVkZ2V0XCI6dHJ1ZSxcIlVuYXBwcm92ZVRpbWVcIjp0cnVlLFwiVmlld1JlYWRPbmx5UGF5cm9sbERhdGFcIjp0cnVlLFwiSW5vdmFMYWJvckJ1cmRlblRydWVVcFwiOnRydWUsXCJDcmVhdGVPdmVyVW5kZXJBZGp1c3RtZW50UmVjb3Jkc1wiOnRydWUsXCJDcmVhdGVSZWNlaXB0XCI6dHJ1ZSxcIkFwcHJvdmVSZWNlaXB0XCI6dHJ1ZSxcIkRlbGV0ZVJlY2VpcHRcIjp0cnVlLFwiQWRkUHVyY2hhc2VDcmVkaXRcIjp0cnVlLFwiU3VibWl0UmVjZWlwdFRvTGFuZHNjYXBlSHViXCI6dHJ1ZSxcIkFsbG93RXN0aW1hdGVOZWdhdGl2ZVF1YW50aXR5XCI6dHJ1ZSxcIkNyZWF0ZUludm9pY2VcIjp0cnVlLFwiVmlld0ludm9pY2luZ1wiOnRydWUsXCJFZGl0SW52b2ljaW5nXCI6dHJ1ZSxcIkRlbGV0ZUludm9pY2luZ1wiOnRydWUsXCJDcmVhdGVNaXNjSW52b2ljZVwiOmZhbHNlLFwiVmlld0FSTWFuYWdlbWVudFwiOnRydWUsXCJFZGl0QmlsbGluZ1wiOnRydWUsXCJWaWV3UHVyY2hhc2luZ1wiOnRydWUsXCJWaWV3UmV2ZW51ZVwiOnRydWUsXCJWaWV3UmVwb3J0c1wiOnRydWUsXCJDb21wbGV0ZVdvcmtUaWNrZXRcIjp0cnVlLFwiQXBwcm92ZVdvcmtUaWNrZXRcIjp0cnVlLFwiRGVsZXRlV29ya1RpY2tldFwiOnRydWUsXCJTd2FwQXNOZWVkZWRTZXJ2aWNlc1wiOnRydWUsXCJQYXJ0aWFsT2NjdXJcIjp0cnVlLFwiTW92ZVdvcmtUaWNrZXRDb3N0c1wiOnRydWUsXCJWaWV3T3Bwb3J0dW5pdGllc1wiOnRydWUsXCJWaWV3TXlPcHBvcnR1bml0aWVzXCI6ZmFsc2UsXCJXaW5Db250cmFjdFwiOnRydWUsXCJXaW5Xb3JrT3JkZXJcIjp0cnVlLFwiTG9zZU9wcG9ydHVuaXRpZXNcIjp0cnVlLFwiQWRkQ3JlZGl0TWVtb1wiOnRydWUsXCJUaWNrZXRCdWxrRW1haWxcIjp0cnVlLFwiRWRpdEJ1ZGdldGVkSG91ckFuZFJldmVudWVcIjp0cnVlLFwiUmVwb3J0QWNjZXNzXCI6e30sXCJNb2RpZnlTZW50SW52b2ljZXNcIjp0cnVlLFwiQWRkQ3Jld0xlYWRlckNvbnRhY3RcIjp0cnVlLFwiT3ZlcnJpZGVUb3RhbENvc3RcIjp0cnVlLFwiRWRpdEVhcm5lZFJldmVudWVcIjp0cnVlLFwiVmlld0tQSU92ZXJoZWFkUmVjb3ZlcnlcIjp0cnVlLFwiVmlld0tQSUNsaWVudE1hbmFnZW1lbnRcIjp0cnVlLFwiVmlld0tQSVByb2ZpdExvc3NcIjp0cnVlLFwiVmlld0tQSUZvcmVjYXN0XCI6dHJ1ZSxcIlZpZXdLUElDb21wbGV0ZWRMYWJvckVmZmljaWVuY3lcIjp0cnVlLFwiVmlld0tQSVNhbGVzU2NvcmVDYXJkXCI6dHJ1ZSxcIlZpZXdTYWxlc1BpcGVsaW5lSW5zaWdodFwiOnRydWUsXCJWaWV3Q3VzdG9tZXJJc3N1ZXNJbnNpZ2h0XCI6dHJ1ZSxcIkNsb3NlTW9udGhcIjp0cnVlLFwiQXBwcm92ZUVxdWlwbWVudFwiOnRydWUsXCJEaXNwb3NlRXF1aXBtZW50XCI6dHJ1ZSxcIkRlbGV0ZUVxdWlwbWVudFwiOnRydWUsXCJFcXVpcG1lbnRBZG1pblwiOnRydWUsXCJNYXJrRXF1aXBtZW50SW5TZXJ2aWNlXCI6dHJ1ZSxcIk1hcmtFcXVpcG1lbnRPdXRPZlNlcnZpY2VcIjp0cnVlLFwiUHVyY2hhc2VFcXVpcG1lbnRcIjp0cnVlLFwiUmVxdWVzdEVxdWlwbWVudFwiOnRydWUsXCJWaWV3RXF1aXBtZW50XCI6dHJ1ZSxcIkVzdGltYXRlQ3VzdG9tQ29sdW1uXCI6dHJ1ZSxcIlRyaWdnZXJBdXRvRXhwZW5zZUNyZWF0aW9uXCI6dHJ1ZSxcIlJvdXRlU2NoZWR1bGluZ1wiOnRydWUsXCJBZGRGdWVsUmF0ZVwiOnRydWUsXCJGdWVsQ29zdFJlcG9ydFwiOnRydWUsXCJNYW5hZ2VDdXN0b21GaWVsZHNcIjp0cnVlLFwiUHJvY2Vzc0VsZWN0cm9uaWNQYXltZW50c1wiOnRydWUsXCJWb2lkRWxlY3Ryb25pY1BheW1lbnRzXCI6dHJ1ZSxcIlJlZnVuZEVsZWN0cm9uaWNQYXltZW50c1wiOnRydWUsXCJFeHBpcmluZ0VsZWN0cm9uaWNQYXltZW50TWV0aG9kc0FsZXJ0c1wiOnRydWUsXCJSZWplY3RlZEVsZWN0cm9uaWNQYXltZW50c0FsZXJ0c1wiOnRydWUsXCJBbm51YWxSZW5ld2Fsc1wiOnRydWUsXCJWaWV3Q29tcGFuaWVzXCI6dHJ1ZSxcIkVkaXRDb21wYW5pZXNcIjp0cnVlLFwiQWRkQ29tcGFuaWVzXCI6dHJ1ZSxcIkNhbmNlbENvbnRyYWN0XCI6dHJ1ZSxcIkNhbmNlbFdvcmtPcmRlclwiOnRydWUsXCJNb2RpZnlTT1ZBZnRlck9wcG9ydHVuaXR5SXNXb25cIjp0cnVlLFwiQ2hhbmdlQXNzaWduZWRQcm9wZXJ0eUJyYW5jaFwiOnRydWUsXCJNYW5hZ2VVc2VyUm9sZXNcIjp0cnVlLFwiRWRpdEVxdWlwbWVudENvc3RBZvaWNlTnVtYmVyXCI6ZmFsc2UsXCJSZXN0cmljdEVkaXRpbmdFbXBsb3llZXNcIjpmYWxzZSxcIkNyZWF0ZVByb3BlcnR5RnJvbUNvbnRhY3RcIjp0cnVlLFwiRW5hYmxlRWxlY3Ryb25pY1NpZ25hdHVyZXNcIjp0cnVlLFwiTWFzdGVyU3lzdGVtXCI6ZmFsc2UsXCJTbm93TW9kZVwiOnRydWUsXCJPcHBvcnR1bml0eUJyYW5jaE92ZXJyaWRlXCI63MDQ3NzEwNzYsImlhdCI6MTcwNDY4NDY3Nn0.FALf4zF0kIAf-pZPVmj8wChCDxGRaVuxQPHrzUy-Df0")
--header ("accept", "application/json;odata.metadata=minimal;odata.streaming=true, application/json;odata.metadata=minimal;odata.streaming=false, application/json;odata.metadata=minimal, application/json;odata.metadata=full;odata.streaming=true, application/json;odata.metadata=full;odata.streaming=false, application/json;odata.metadata=full, application/json;odata.metadata=none;odata.streaming=true, application/json;odata.metadata=none;odata.streaming=false, application/json;odata.metadata=none, application/json;odata.streaming=true, application/json;odata.streaming=false, application/json, application/xml, application/prs.odatatestxx-odata, text/plain, text/json")
le
Use to get a value that is less than or equal.
Example | |
Desired outcome | Only return clock times that contain a break time that is less than or equal to one. |
Base URL | https://cloud-api.youraspire.com |
Resource | ClockTimes |
Query Parameter | $filter |
Filter option | BreakTime le 1 |
Query | https://cloud-api.youraspire.com?$filter=BreakTime le 1 |
Example Response
[
{
"ClockTimeID": 17662,
"ContactID": 22609,
"ContactName": "Jimmy Labor",
"ClockStart": "2016-10-10T08:00:00Z",
"ClockEnd": "2016-10-10T16:30:00Z",
"AcceptedDateTime": "2016-11-01T18:28:59.557Z",
"AcceptedUserID": 3197,
"AcceptedUserName": "A User Name",
"BreakTime": 0.5,
"AcceptedShortLunch": false,
"UsedBreaks": false,
"PreventedFromUsingBreaks": false,
"GEOLocationStartLatitude": null,
"GEOLocationStartLongitude": null,
"GEOLocationEndLatitude": null,
"GEOLocationEndLongitude": null
}
]
Code Sample
curl --request GET \
--url ("https://acloud-api.youraspire.com/ClockTimes?%24filter=BreakTime%20le%201%20")
--header ("Authorization", "eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJBc3BpcmVTeXN0ZW1JRCI6IjE1IiwiVXNlcklEIjoiNDg0OCIsIlVzZXJQZXJtaXNzaW9ucyI6IntcIlJvbGVJRFwiOjAsXCJSb2xlTmFtZVwiOm51bGwsXCJSZXF1aXJlZFwiOmZhbHNlLFwiUm9sZVZhbHVlXCI6MSxcIkFkZENvbnRhY3RcIjp0cnVlLFwiRWRpdE15Q29udGFjdHNcIjp0cnVlLFwiRWRpdEFsbENvbnRhY3RzXCI6dHJ1ZSxcIkRlbGV0ZUNvbnRhY3RcIjpmYWxzZSxcIkFkZEVtcGxveWVlSW5jaWRlbnRcIjp0cnVlLFwiRWRpdEFjY291bnRpbmdTeW5jSURcIjp0cnVlLFwiQnVsa0VtYWlsQ29udGFjdHNcIjp0cnVlLFwiU2VuZEN1c3RvbWVyUGRGl2aXNpb25JREZvcld25UeXBlXCI6NyxcIkRlZmF1bHRQcm9wZXJ0eVRha2VvZmZQcm92aWRlclwiOjQsXCJEZWZhdWx0RXN0aW1hdGVUYWtlb2ZmUHJvdmlkZXJcIjo0LFwiRW5hYmxlV2ViUmVwb3J0RGVzaWduZXJcIjpmYWxzZSxcIkF6dWdhQ3VzdG9tZXJJRFwiOjEwNTksXCJFbmFibGVDcmV3TWVtYmVyQ2xvY2tJbldpdGhvdXRDcmV3TGVhZGVyXCI6ZmFsc2UsXCJFbmFibGVFT01SZXBvcnRcIjpmYWxzZSxcIlVzZU9wcG9ydHVuaXR5SXRlbURpc3BsYXlOYW1lT25JbnZvaWNlXCI6dHJ1ZSxcIkVuYWJsZVZpc2l0Q2hlY2tsaXN0c1wiOnRydWUsXCJUaW1lWm9uZVwiOlwiQW1lcmljYS9DaGljYWdvXCIsXCJGaXJzdERheU9mV2Vla1wiOlwiTW9uZGF5XCIsXCJJbm92YUVuYWJsZWRcIjp0cnVlLFwiUFRPVmlzaWJsZVwiOnRydWUsXCJNYXJrZXRpbmdQcm9JbnRlZ3JhdGlvblwiOmZhbHNlLFwiTWFya2V0aW5nUHJvVmVyc2lvblwiOm51bGwsXCJFbNzYsImlhdCI6MTcwNDY4NDY3Nn0.FALf4zF0kIAf-pZPVmj8wChCDxGRaVuxQPHrzUy-Df0")
--header ("accept", "application/json;odata.metadata=minimal;odata.streaming=true, application/json;odata.metadata=minimal;odata.streaming=false, application/json;odata.metadata=minimal, application/json;odata.metadata=full;odata.streaming=true, application/json;odata.metadata=full;odata.streaming=false, application/json;odata.metadata=full, application/json;odata.metadata=none;odata.streaming=true, application/json;odata.metadata=none;odata.streaming=false, application/json;odata.metadata=none, application/json;odata.streaming=true, application/json;odata.streaming=false, application/json, application/xml, application/prs.odatatestxx-odata, text/plain, text/json")
Logical operators
Use logical operations to combine conditions.
and
combine multiple conditions; all conditions must be true.
or
use to combine multiple conditions and require that at least one condition is true.
Example | |
Desired outcome | Only return active contacts containing a Company ID of 1000 or an email equal to user@email.com. |
Base URL | https://cloud-api.youraspire.com |
Resource | Contacts |
Query Parameter | $filter |
Filter option | (Active eq true and CompanyID ne 1000 or Email eq 'user@email.com' |
Query | https://cloud-api.youraspire.com?$filter=(Active eq true and CompanyID ne 1000 or Email eq 'user@email.com' |
Example Response
[
{
"ContactID": 1,
"CompanyID": 1,
"CompanyName": "string",
"ContactTypeID": 1,
"ContactTypeName": "string",
"OfficeAddress": {
"AddressID": 1,
"AddressLine1": "string",
"AddressLine2": "string",
"City": "string",
"StateProvinceCode": "string",
"ZipCode": "string",
"CreatedByUserId": 1,
"CreatedOn": "string",
"LastModifiedByUserId": 1,
"LastModifiedOn": "string"
},
"HomeAddress": {
"AddressID": 1,
"AddressLine1": "string",
"AddressLine2": "string",
"City": "string",
"StateProvinceCode": "string",
"ZipCode": "string",
"CreatedByUserId": 1,
"CreatedOn": "string",
"LastModifiedByUserId": 1,
"LastModifiedOn": "string"
},
"BranchID": 1,
"BranchName": "string",
"OwnerContactID": 1,
"OwnerContactName": "string",
"Salutation": "string",
"FirstName": "string",
"LastName": "string",
"ProspectRating": "string",
"ProspectRatingName": "string",
"Title": "string",
"Email": "string",
"MobilePhone": "string",
"OfficePhone": "string",
"HomePhone": "string",
"Fax": "string",
"Notes": "string",
"Active": true,
"CreatedDateTime": "string",
"CreatedByUserID": 1,
"CreatedByUserName": "string",
"EmployeeNumber": "string",
"Website": "string",
"EmployeePin": "string",
"AccountingSyncID": "string",
"ExternalContactReference": "string",
"TerminationDate": "string",
"HRNotes": "string",
"DefaultWorkersCompID": 1,
"DefaultWorkersCompName": "string",
"DefaultWorkersCompStateProvinceCode": "string",
"UserID": 1,
"CrewSize": 1,
"PromptForCrewSize": true,
"SubCrewLeaderContactID": 1,
"PayScheduleID": 1,
"ModifiedDate": "string",
"ContactTags": [
{
"ContactTagID": 1,
"TagID": 1,
"TagName": "string"
}
]
}
]
Code Sample
curl --request GET \
--url ("https://cloud-api.youraspire.com/Contacts?%24filter=(Active%20eq%20true%20and%20CompanyID%20ne%201000)%20or%20Email%20eq%20'user%40email.com'")
--header ("Authorization", "eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJBc3BpcmVTeXN0ZW1JRCI6IjE1IiwiVXNlcklEIjoiNDg0OCIsIlVzZXJQZXJtaXNzaW9ucyI6IntcIlJvbGVJRFwiOjAsXCJSb2xlTmFtZVwiOm51bGwsXCJSZXF1aXJlZFwiOmZhbHNlLFwiUm9sZVZhbHVlXCI6MSxcIkFkZENvbnRhY3RcIjp0cnVlLFwiRWRpdE15Q29udGFjdHNcIjp0cnVlLFwiRWRpdEFsbENvbnRhY3RzXCI6dHJ1ZSxcIkRlbGV0ZUNvbnRhY3RcIjpmYWxzZSxcIkFkZEVtcGxveWVlSW5jaWRlbnRcIjp0cnVlLFwiRWRpdEFjY291bnRpbmdTeW5jSURcIjp0cnVlLFwiQnVsa0VtYWlsQ29udGFjdHNcIjp0cnVlLFwiU2VuZEN1c3RvbWVyUG9ydGFsSW52aXRhdGlvblwiOnRydWUsXCJJbXBvcnRDb250YWN0QW5kUHJvcGVydHlcIjp0cnVlLFwiQ29uZmlndXJlQ29udGFjdFJlcXVpcmVkRmllbGRzXCI6dHJ1ZSxcIkRlbGV0ZU1lcmdlQ29udGFjdHNcIjp0cnVlLFwiVXBkYXRlRW1wbG95ZWVQSU5cIjpmYWxzZSxcIkFkZFByb3BlcnR5XCI6dHJ1ZSxcIkVkaXRNeVByb3BlcnRpZXNcIjp0cnVlLFwiRWRpdEFsbFByb3BlcnRpZXNcIjp0cnVlLFwiRGVsZXRlUHJvcGVydHlcIjpmYWxzZSxcIkVkaXRRdWFsaXR5QXVkaXRzXCI6dHJ1ZSxcIlZpZXdQcm9wZXJ0aWVzXCI6dHJ1ZSxcIlZpZXdNeVByb3BlcnRpZXNcIjpmYWxzZSxcIkFkZE9wcG9ydHVuaXR5XCI6dHJ1ZSxcIkVkaXRNeU9wcG9ydHVuaXRpZXNcIjp0cnVlLFwiRWRpdEFsbE9wcG9ydHVuaXRpZXNcIjp0cnVlLFwiRGVsZXRlT3Bwb3J0dW5pdHlcIjp0cnVlLFwiQ2hhbmdlT3Bwb3J0dW5pdHlcIjp0cnVlLFwiVmlld1JlYWRPbmx5RXN0aW1hdGVzXCI6dHJ1ZSxcIlVuY2FuY2VsT3Bwb3J0dW5pdHlcIjp0cnVlLFwiSm9iRGFzaGJvYXJkXCI6dHJ1ZSxcIkltcG9ydEVzdGltYXRlXCI6dHJ1ZSxcIkVkaXRTZXJ2aWNlUGF5Q29kZXNcIjp0cnVlLFwiRGVsZXRlQWN0aXZpdHlcIjp0cnVlLFwiU3lzdGVtQWRtaW5cIjp0cnVlLFwiQnJhbmNoQWRtaW5cIjpmYWxzZSxcIlZpZXdSb3V0ZXNcIjp0cnVlLFwiTWFuYWdlT3Bwb3J0dW5pdHlUZW1wbGF0ZXNcIjp0cnVlLFwiTWFuYWdlR2VuZXJhbENvbmRpdGlvblRlbXBsYXRlc1wiOnRydWUsXCJNYWtlVmlzaXRDaGVja2xpc3RJdGVtc01hbmRhdG9yeVwiOnRydWUsXCJFZGl0RGFpbHlQbGFuUmVwb3J0XCI6dHJ1ZSxcIk1hcmtldGluZ1Byb1wiOnRydWUsXCJFeHBvcnRHcmlkc1wiOnRydWUsXCJFZGl0VGVtcGxhdGVzXCI6dHJ1ZSxcIk1hbmFnZVRlbXBsYXRlc1wiOnRydWUsXCJFZGl0RXN0aW1hdGVQcmljaW5nUGN0XCI6dHJ1ZSxcIkVkaXRFc3RpbWF0ZUl0ZW1zXCI6dHJ1ZSxcIkhvdXJSZWR1Y3Rpb25QY3RcIjoxMDAuMCxcIlByaWNlUmVkdWN0aW9uUGN0XCI6MTAwLjAsXCJVbmJhbGFuY2VkUGF5bWVudFNjaGVkdWxlXCI6dHJ1ZSxcIkFsbG93T25lVGltZUl0ZW1zXCI6dHJ1ZSxcIkFkZEl0ZW1zVG9DYXRhbG9nXCI6dHJ1ZSxcIkNoYW5nZVNlcnZpY2VJbnZvaWNlVHlwZU9uRml4ZWRQcmljZU9wZW5CaWxsaW5nXCI6dHJ1ZSxcIkFkanVzdEdlbmVyYWxDb25kaXRpb25zXCI6dHJ1ZSxcIkFkZE1vZGlmeVBheWNvZGVPdmVycmlkZXNcIjp0cnVlLFwiQXNOZWVkZWRFeGNlcHRpb25SZXBvcnRcIjp0cnVlLFwiTWFrZU9wcG9ydHVuaXR5U2VydmljZVZpc2l0Q2hlY2tsaXN0SXRlbXNNYW5kYXRvcnlcIjp0cnVlLFwiUHJvZHVjdGlvblwiOmZhbHNlLFwiVXBkYXRlSm9iXCI6ZmFsc2UsXCJDYW5jZWxXb3JrVGlja2V0XCI6dHJ1ZSxcIlNjaGVkdWxlQm9hcmRcIjp0cnVlLFwiU2NoZWR1bGVCb2FyZFJlYWRPbmx5XCI6dHJ1ZSxcIlJvdXRlT3B0aW1pemF0aW9uXCI6dHJ1ZSxcIlNjaGVkdWxlQW5FdmVudFwiOnRydWUsXCJBY2Nlc3NBdXRvVGltZUFjY2VwdGFuY2VSZXBvcnRzXCI6ZmFsc2UsXCJFZGl0Um91dGVzXCI6dHJ1ZSxcIkNyZXdMZWFkZXJcIjp0cnVlLFwiRXN0aW1hdGVcIjpmYWxzZSxcIlZpZXdBbGxUaW1lXCI6dHJ1ZSxcIk15UmVwb3J0c1wiOnRydWUsXCJBZHZhbmNlZFNlYXJjaFN5c3RlbUFkbWluXCI6ZmFsc2UsXCJIUkFkbWluXCI6dHJ1ZSxcIlNhbGVzTWFuYWdlclwiOnRydWUsXCJFZGl0UHJvcGVydHlCaWxsaW5nQ29udGFjdFwiOnRydWUsXCJVbmFwcHJvdmVSZWNlaXB0XCI6dHJ1ZSxcIkFwcHJvdmVUaW1lXCI6dHJ1ZSxcIkV4cG9ydFRpbWVcIjp0cnVlLFwiRWRpdFByaWNpbmdcIjp0cnVlLFwiQ2hvb3NlUmVwb3J0RXhwb3J0VHlwZVwiOnRydWUsXCJFZGl0QnVkZ2V0XCI6dHJ1ZSxcIlVuYXBwcm92ZVRpbWVcIjp0cnVlLFwiVmlld1JlYWRPbmx5UGF5cm9sbERhdGFcIjp0cnVlLFwiSW5vdmFMYWJvckJ1cmRlblRydWVVcFwiOnRydWUsXCJDcmVhdGVPdmVyVW5kZXJBZGp1c3RtZW50UmVjb3Jkc1wiOnRydWUsXCJDcmVhdGVSZWNlaXB0XCI6dHJ1ZSxcIkFwcHJvdmVSZWNlaXB0XCI6dHJ1ZSxcIkRlbGV0ZVJlY2VpcHRcIjp0cnVlLFwiQWRkUHVyY2hhc2VDcmVkaXRcIjp0cnVlLFwiU3VibWl0UmVjZWlwdFRvTGFuZHNjYXBlSHViXCI6dHJ1ZSxcIkFsbG93RXN0aW1hdGVOZWdhdGl2ZVF1YW50aXR5XCI6dHJ1ZSxcIkNyZWF0ZUludm9pY2VcIjp0cnVlLFwiVmlld0ludm9pY2luZ1wiOnRydWUsXCJFZGl0SW52b2ljaW5nXCI6dHJ1ZSxcIkRlbGV0ZUludm9pY2luZ1wiOnRydWUsXCJDcmVhdGVNaXNjSW52b2ljZVwiOmZhbHNlLFwiVmlld0FSTWFuYWdlbWVudFwiOnRydWUsXCJFZGl0QmlsbGluZ1wiOnRydWUsXCJWaWV3UHVyY2hhc2luZ1wiOnRydWUsXCJWaWV3UmV2ZW51ZVwiOnRydWUsXCJWaWV3UmVwb3J0c1wiOnRydWUsXCJDb21wbGV0ZVdvcmtUaWNrZXRcIjp0cnVlLFwiQXBwcm92ZVdvcmtUaWNrZXRcIjp0cnVlLFwiRGVsZXRlV29ya1RpY2tldFwiOnRydWUsXCJTd2FwQXNOZWVkZWRTZXJ2aWNlc1wiOnRydWUsXCJQYXJ0aWFsT2NjdXJcIjp0cnVlLFwiTW92ZVdvcmtUaWNrZXRDb3N0c1wiOnRydWUsXCJWaWV3T3Bwb3J0dW5pdGllc1wiOnRydWUsXCJWaWV3TXlPcHBvcnR1bml0aWVzXCI6ZmFsc2UsXCJXaW5Db250cmFjdFwiOnRydWUsXCJXaW5Xb3JrT3JkZXJcIjp0cnVlLFwiTG9zZU9wcG9ydHVuaXRpZXNcIjp0cnVlLFwiQWRkQ3JlZGl0TWVtb1wiOnRydWUsXCJUaWNrZXRCdWxrRW1haWxcIjp0cnVlLFwiRWRpdEJ1ZGdldGVkSG91ckFuZFJldmVudWVcIjp0cnVlLFwiUmVwb3J0QWNjZXNzXCI6e30sXCJNb2RpZnlTZW50SW52b2ljZXNcIjp0cnVlLFwiQWRkQ3Jld0xlYWRlckNvbnRhY3RcIjp0cnVlLFwiT3ZlcnJpZGVUb3RhbENvc3RcIjp0cnVlLFwiRWRpdEVhcm5lZFJldmVudWVcIjp0cnVlLFwiVmlld0tQSU92ZXJoZWFkUmVjb3ZlcnlcIjp0cnVlLFwiVmlld0tQSUNsaWVudE1hbmFnZW1lbnRcIjp0cnVlLFwiVmlld0tQSVByb2ZpdExvc3NcIjp0cnVlLFwiVmlld0tQSUZvcmVjYXN0XCI6dHJ1ZSxcIlZpZXdLUElDb21wbGV0ZWRMYWJvckVmZmljaWVuY3lcIjpXCI6XCJFbmQgb2YgRGF5XCIsXCJTaG93TmV0R3Jvc3NNYXJnaW5PbkVzdGltYXRpbmdTY3JlZW5cIjp0cnVlLFwiJmIjoxNzA0Njg0Njc2LCJleHAiOjE3MDQ3NzEwNzYsImlhdCI6MTcwNDY4NDY3Nn0.FALf4zF0kIAf-pZPVmj8wChCDxGRaVuxQPHrzUy-Df0")
--header ("accept", "application/json;odata.metadata=minimal;odata.streaming=true, application/json;odata.metadata=minimal;odata.streaming=false, application/json;odata.metadata=minimal, application/json;odata.metadata=full;odata.streaming=true, application/json;odata.metadata=full;odata.streaming=false, application/json;odata.metadata=full, application/json;odata.metadata=none;odata.streaming=true, application/json;odata.metadata=none;odata.streaming=false, application/json;odata.metadata=none, application/json;odata.streaming=true, application/json;odata.streaming=false, application/json, application/xml, application/prs.odatatestxx-odata, text/plain, text/json")
Built-in functions
Built-in functions are similar to operators but allow you to execute specific operations on data values outside of comparisons. They can perform specific operations on data values, string manipulations, date operations, etc. They can be used with string and DateTime data types. When using built-in functions with string data types, you must enclose properties/fields with parentheses.
Common built-in functions:
Use with string data type:
- startswith - returns values when the first characters are defined within the string or collection is true.
- endswith - returns values when the last characters defined in the string or collection are true. This can only be used with strings.
- contains - returns value when defined entity within string or collection is true.
- lengths - returns value when the number of characters defined is true.
- toupper - converts string value to uppercase.
- tolower - converts string value to lowercase.
Example | |
Desired outcome | Retrieve a list of branches with a branch name that starts with ST and an address line 1 that contains 39000 S Woods on the legal name Company. |
Base URL | https://cloud-api.youraspire.com |
Resource | Branches |
Query Parameter | $filter |
Filter option | (startswith(BranchName,'St.')and contains (BranchAddressLine1,'39000 S Woods') or contains (LegalName,'Company') |
Query | https://cloud-api.youraspire.com?$filter=(startswith(BranchName,'St.')and contains (BranchAddressLine1,'39000 S Woods') or contains (LegalName,'Company') |
Example Response
[
{
"BranchID": 50,
"BranchName": "St. Louis",
"Active": true,
"InternalPropertyID": 70339,
"InternalPropertyName": "Indirect St.Loiuse",
"CatalogPriceListName": "Q - Main Prices 1111",
"BranchAddressID": 34121,
"BranchAddressLine1": "390 S Woods Mill Rd Suite 200",
"BranchAddressLine2": "390 S Woods Mill Rd Suite 200",
"BranchAddressCity": "Chesterfield",
"BranchAddressStateProvinceCode": "MO",
"BranchAddressZipCode": "63017",
"BranchPhone": "(636) 000-0000",
"BranchFax": "(636) 000-0000",
"BranchCode": "STL",
"BranchManagerContactID": 67654,
"BranchManagerContactName": "Name Adela",
"LegalName": "Company",
"TimeZone": "Eastern Standard Time",
"InvoiceNumberPrefix": "STL",
"ReceiptNumberPrefix": null,
"OpportunityNumberPrefix": "STL",
"RegionID": 5,
"RegionName": "Southwest Region",
"BillingEmailFromAccountOwner": true,
"BillingEmailFromUserName": null,
"BillingEmailFromEmail": null,
"BillingEmailSubject": null,
"BillingEmailBody": "<div style=\"font-size: 14pt;\" id=\"fontFamilySizeSetting\"><div style=\"font-family: Arial,Helvetica,sans-serif;\" id=\"fontFamilySetting\"><p><span></span>
</p><p>
</p></div></div>",
"InvoiceOnCompletionDescription": null,
"BranchWebSite": "test",
"CatalogPriceListID": 31,
"BillingEmailCC": null
}
]
Code Sample
curl --request GET \
--url ("https://cloud-api.youraspire.com/Branches?%24filter=(startswith(BranchName%2C%20'St.')%20and%20contains(BranchAddressLine1%2C%20'39000%20S%20Woods'))%20or%20contains(LegalName%2C%20'Incrediscape')")
--header ("Authorization", "eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJBc3BpcmVTeXN0ZW1JRCI6IjE1IiwiVXNlcklEIjoiNDg0OCIsIlVzZXJQZXJtaXNzaW9ucyI6IntcIlJvbGVJRFwiOjAsXCJSb2xlTmFtZVwiOm51bGwsXCJSZXF1aXJlZFwiOmZhbHNlLFwiUm9sZVZhbHVlXCI6MSxcIkFkZENvbnRhY3RcIjp0cnVlLFwiRWRpdE15Q29udGFjdHNcIjp0cnVlLFwiRWRpdEFsbENvbnRhY3RzXCI6dHJ1ZSxcIkRlbGV0ZUNvbnRhY3RcIjpmYWxzZSxcIkFkZEVtcGxveWVlSW5jaWRlbnRcIjp0cnVlLFwiRWRpdEFjY291bnRpbmdTeW5jSURcIjp0cnVlLFwiQnVsa0VtYWlsQ29udGFjdHNcIjp0cnVlLFwiU2VuZEN1c3RvbWVyUG9ydGFsSW52aXRhdGlvblwiOnRydWUsXCJJbXBvcnRDb250YWN0QW5kUHJvcGVydHlcIjp0cnVlLFwiQ29uZmlndXJlQ29udGFjdFJlcXVpcmVkRmllbGRzXCI6dHJ1ZSxcIkRlbGV0ZU1lcmdlQ29udGFjdHNcIjp0cnVVBdXRvVGltZUFjY2VwdGFuY2VDb25maWdcIjpmYWxzZSxcIkVuYWJsZUF1dG9UaW1lQWNjZXB0YW5jZVwiOmZhbHNlLFwiRW50ZXJwcmlzZUFkbWluVHlwZVwiOjB9IiwiRm9yYmlkZGVuIjoiIiwibmJmIjoxNzA0Njg0Njc2LCJleHAiOjE3MDQ3NzEwNzYsImlhdCI6MTcwNDY4NDY3Nn0.FALf4zF0kIAf-pZPVmj8wChCDxGRaVuxQPHrzUy-Df0")
--header ("accept", "application/json;odata.metadata=minimal;odata.streaming=true, application/json;odata.metadata=minimal;odata.streaming=false, application/json;odata.metadata=minimal, application/json;odata.metadata=full;odata.streaming=true, application/json;odata.metadata=full;odata.streaming=false, application/json;odata.metadata=full, application/json;odata.metadata=none;odata.streaming=true, application/json;odata.metadata=none;odata.streaming=false, application/json;odata.metadata=none, application/json;odata.streaming=true, application/json;odata.streaming=false, application/json, application/xml, application/prs.odatatestxx-odata, text/plain, text/json")
DateTime functions:
- second
- minute
- hour
- day
- month
- year
- time
Example | |
Desired outcome | Retrieve a list of opportunities with a won date of 02/28/2023 or a lost date that did not occur in 2022. |
Base URL | https://cloud-api.youraspire.com |
Resource | Opportunities |
Query Parameter | $filter |
Filter option | Date(WonDate) eq 2023-02-28 or Year(LostDate) ne 2022 |
Query | https://cloud-api.youraspire.com?$filter=Date(WonDate) eq 2023-02-28 or Year(LostDate) ne 2022 |
Example Response
[
{
"OpportunityID": 20573,
"PropertyID": 32671,
"OpportunityStatusID": 510,
"OpportunityStatusName": "Lost",
"SalesRepContactID": 22601,
"SalesRepContactName": "Sally Salesrep",
"OperationsManagerContactID": 22596,
"OperationsManagerContactName": "Joe Barry",
"DivisionID": 90,
"DivisionName": "Enhancement",
"BranchID": 50,
"BranchName": "St. Louis",
"SalesTypeID": 29,
"SalesTypeName": "New Sale",
"TemplateOpportunityID": null,
"LeadSourceID": null,
"LeadSourceName": null,
"MasterOpportunityID": null,
"BillingAddressID": 34110,
"BillingAddressLine1": "1 Barnes Jewish Hospital Plaza",
"BillingAddressLine2": null,
"BillingAddressCity": "St. Louis",
"BillingAddressStateProvinceCode": "MO",
"BillingAddressZipCode": "63521",
"OpportunityType": "Work Order",
"MasterSequenceNum": null,
"OpportunityName": "Spring Mulch Refresh",
"ProposalDescription1": "<div style=\"font-family: Verdana;\" id=\"fontFamilySetting\"><p>Test for Tab again hjbhb</p><p>check <span>[AccountOwnerContactHomePhone]</span></p><p><span>
</span></p><p></p><p><img src=\"https://aspire-clouduat-attach.youraspire.com/AspireUploads/15/opportunity/20573/1885795.jpg\" alt=\"common irrigation repair..jpg\" data-attachment=\"{"ExposeToCrew":false,"AttachToInvoice":false,"AttachmentSize":"MEDIUM","ActivityIDs":[],"ObjectCode":"OPPORTUNITY","OpportunityID":20573,"OriginalFileName":"common irrigation repair..jpg","AttachmentName":"common irrigation repair..jpg","AttachmentTypeID":34}\" width=\"360\" class=\"e-rte-image e-imginline\"></p><p></p><p>
</p><p></p><p>
</p><p>
</p></div>",
"StartDate": "2016-11-01T00:00:00Z",
"EndDate": "2016-12-31T00:00:00Z",
"BidDueDate": null,
"CreatedDateTime": "2016-11-08T20:44:01.07Z",
"ApprovedDate": "2017-03-09T18:39:13.817Z",
"ProposedDate": "2020-08-26T19:42:47.873Z",
"WonDate": "2017-03-09T18:39:19.943Z",
"LostDate": "2023-11-09T12:54:40.867Z",
"Probability": 0,
"AnticipatedCloseDate": null,
"InvoiceType": "Fixed Price on Completion",
"CustomerContractNum": null,
"CustomerPONum": null,
"BudgetedDollars": 0,
"EstimatedDollars": 377.99,
"StateTaxPercent": 9,
"FederalTaxPercent": 0,
"CreatedByUserID": 3197,
"CreatedByUserName": "A User Name",
"ApprovedUserID": 3317,
"ApprovedUserName": "Joe Barry",
"ProposedUserID": 3317,
"ProposedUserName": "Joe Barry",
"ClosedUserID": 3643,
"ClosedUserName": "A Name",
"CompetitorID": null,
"CompetitorName": null,
"LostReason": null,
"BillingContactID": 22554,
"BillingContactName": "Billing Contact",
"ProposalDescription2": null,
"OpportunityNumber": 1016,
"EstimatedCostDollars": 147,
"EstimatedOverheadDollars": 136.5,
"EstimatedBreakEvenDollars": 283.5,
"EstimatedNetProfitPercent": 25,
"EstimatedNetProfitDollars": 94.49,
"EstimatedGrossMarginPercent": 61.11,
"EstimatedGrossMarginDollars": 230.99,
"EstimatedLaborHours": 3,
"EstimatedLaborCostPerHour": 35,
"EstimatedRealizeRate": 98,
"EstimatedEquipmentCost": 0,
"EstimatedLaborCost": 105,
"EstimatedMaterialCost": 42,
"EstimatedOtherCost": 0,
"EstimatedSubCost": 0,
"ActualCostDollars": 528.55,
"ActualGrossMarginPercent": -196.95,
"ActualGrossMarginDollars": -350.56,
"ActualLaborHours": 18.5,
"ActualLaborCostPerHour": 26.3,
"ActualEarnedRevenue": 177.99,
"InvoiceNote": "<p>Refresh spring mulch in March in all areas of property.</p>",
"PercentComplete": 1,
"RenewalDate": null,
"ModifiedByUserID": 3317,
"ModifiedByUserName": "Joe Barry",
"ModifiedDate": "2023-12-04T16:24:08.617Z",
"OverridePaymentTermsID": 41,
"OverridePaymentTerms": "Net 30",
"RetainagePercent": null,
"EstimatorNotes": "<p>Purchase extra mulch anticipate it will be needed. </p>",
"ElectronicPaymentsOverrideConvenienceFee": null,
"OpportunityCanceledReasonID": null,
"OpportunityCanceledReason": null,
"RetainageMaturityDate": null,
"DistrictName": "District West13",
"JobStatusName": "Complete",
"RegionName": "Southwest Region",
"PaymentTermsID": 41,
"BillingCompanyID": 7683,
"BillingCompanyName": "BJC",
"BranchCode": "STL",
"PropertyName": "Barnes Jewish Hospital",
"DivisionCode": "EN",
"TaxablePercent": 0,
"TaxableAmount": 0,
"TMPerServiceTaxableAmount": 0,
"ActualCostSub": 0,
"ActualCostMaterial": 42,
"ActualCostLabor": 486.55,
"CompleteDate": "2017-03-09T18:47:52.243Z",
"OpportunityRevisions": [],
"OpportunityBillings": [],
"ScheduleOfValueGroups": []
}
]
Code Sample
curl --request GET \
--url ("https://cloud-api.youraspire.com/Opportunities?%24filter=Date(WonDate)%20eq%202023-02-28%20or%20Year(LostDate)%20ne%202022")
--header ("Authorization", "eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJBc3BpcmVTeXN0ZW1JRCI6IjE1IiwiVXNlcklEIjoiNDg0OCIsIlVzZXJQZXJtaXNzaW9ucyI6IntcIlJvbGVJRFwiOjAsXCJSb2xlTmFtZVwiOm51bGwsXCJSZXF1aXJlZFwiOmZhbHNlLFwiUm9sZVZhbHVlXCI6MSxcIkFkZENvbnRhY3RcIjp0cnVlLFwiRWRpdE15Q29udGFjdHNcIjp0cnVlLFwiRWRpdEFsbENvbnRhY3RzXCI6dHJ1ZSxcIkRlbGV0ZUNvbnRhY3RcIjpmYWxzZSxcIkFkZEVtcGxveWVlSW5jaWRlbnRcIjp0cnVlLFwiRWRpdEFjY291bnRpbmdTeW5jSURcIjp0cnVlLFwiQnVsa0VtYWlsQ29udGFjdHNcIjp0cnVlLFwiU2VuZEN1c3RvbWVyUG9ydGFsSW52aXRhdGlvblwiOnRydWUsXCJJbXBvcnRDb250YWN0QW5kUHJvcGVydHlcIjp0cnVlLFwiQ29uZmlndXJlQ29udGFjdFJlcXVpcmVkRmllbGRzXCI6dHJ1ZSxcIkRlbGV0ZU1lcmdlQ29udGFjdHNcIjp0cnVlLFwiVXBkYXRlRW1wbG95ZWVQSU5cIjpmYWxzZSxcIkFkZFByb3BlcnR5XCI6dHJ1ZSxcIkVkaXRNeVByb3BlcnRpZXNcIjp0cnVlLFwiRWRpdEFsbFByb3BlcnRpZXNcIjp0cnVlLFwiRGVsZXRlUHJvcGVydHlcIjpmYWxzZSxcIkVkaXRRdWFsaXR5QXVkaXRzXCI6dHJ1ZSxcIlZpZXdQcm9wZXJ0aWVzXCI6dHJ1ZSxcIlZpZXdNeVByb3BlcnRpZXNcIjpmYWxzZSxcIkFkZE9wcG9ydHVuaXR5XCI6dHJ1ZSxcIkVkaXRNeU9wcG9ydHVuaXRpZXNcIjp0cnVlLFwiRWRpdEFsbE9wcG9ydHVuaXRpZXNcIjp0cnVlLFwiRGVsZXRlT3Bwb3J0dW5pdHlcIjp0cnVlLFwiQ2hhbmdlT3Bwb3J0dW5pdHlcIjp0cnVlLFwiVmlld1JlYWRPbmx5RXN0aW1hdGVzXCI6dHJ1ZSxcIlVuY2FuY2VsT3Bwb3J0dW5pdHlcIjp0cnVlLFwiSm9iRGFzaGJvYXJkXCI6dHJ1ZSxcIkltcG9ydEVzdGltYXRlXCI6dHJ1ZSxcIkVkaXRTZXJ2aWNlUGF5Q29kZXNcIjp0cnVlLFwiRGVsZXRlQWN0aXZpdHlcIjp0cnVlLFwiU3lzdGVtQWRtaW5cIjp0cnVlLFwiQnJhbmNoQWRtaW5cIjpmYWxzZSxcIlZpZXdSb3V0ZXNcIjp0cnVlLFwiTWFuYWdlT3Bwb3J0dW5pdHlUZW1wbGF0ZXNcIjp0cnVlLFwiTWFuYWdlR2VuZXJhbENvbmRpdGlvblRlbXBsYXRlc1wiOnRydWUsXCJNYWtlVmlzaXRDaGVja2xpc3RJdGVtc01hbmRhdG9yeVwiOnRydWUsXCJFZGl0RGFpbHlQbGFuUmVwb3J0XCI6dHJ1ZSxcIk1hcmtldGluZ1Byb1wiOnRydWUsXCJFeHBvcnRHcmlkc1wiOnRydWUsXCJFZmVkaXRcIjp0cnVlLFwiU3VibWl0UmVjZWlwdFRvTGFuZHNjYXBlSHViXCI6dFwiOjEyMDIsXCJSZXF1aXJlTm9PcGVuSW52b2ljZXNDaGVja1wiOnRydWUsXCJQcm9kdWN0VGllclwiOjAsXCJDYW5BY2Nlc3NBUElzXCI6ZmFsc2UsXCJIYXNGYWNpYWxSZWNcIjpmYWxzZSxcIkVuYWJsZVRha2VvZmZJbnRlZ3JhdGlvblwiOnRydWUsXCJUYWtlb2ZmSW50ZWdyYXRpb25UeXBlXCI6NyxcIkRlZmF1bHRQcm9wZXJ0eVRha2VvZmZQcm92aWRlclwiOjQsXCJEZWZhdWx0RXN0aW1hdGVUYWtlb2ZmUHJvdmlkZXJcIjo0LFwiRW5hYmxlV2ViUmVwb3J0RGVzaWduZXJcIjpmYWxzZSxcIkF6dWdhQ3VzdG9tZXJJRFwiOjEwNTksXCJFbmFibGVDcmV3TWVtYmVyQ2xvY2tJbldpdGhvdXRDcmV3TGVhZGVyXCI6ZmFsc2UsXCJFbmFibGVFT01SZXBvcnRcIjpmYWxzZSxcIlVzZU9wcG9ydHVuaXR5SXRlbURpc3BsYXlOYW1lT25JbnZvaWNlXCI6dHJ1ZSxcIkVuYWJsZVZpc2l0Q2hlY2tsaXN0c1wiOnRydWUsXCJUaW1lWm9uZVwiOlwiQW1lcmljYS9DaGljYWdvXCIsXCJGaXJzdERheU9mV2Vla1wiOlwiTW9uZGF5XCIsXCJJbm92YUVuYWJsZWRcIjp0cnVlLFwiUFRPVmlzaWJsZVwiOnRydWUsXCJNYXJrZXRpbmdQcm9JbnRlZ3JhdGlvblwiOmZhbHNlLFwiTWFya2V0aW5nUHJvVmVyc2lvblwiOm51bGwsXCJFbmFibGVBdXRvVGltZUFjY2VwdGFuY2VDb25maWdcIjpmYWxzZSxcIkVuYWJsZUF1dG9UaW1lQWNjZXB0YW5jZVwiOmZhbHNlLFwiRW50ZXJwcmlzZUFkbWluVHlwZVwiOjB9IiwiRm9yYmlkZGVuIjoiIiwibmJmIjoxNzA0Njg0Njc2LCJleHAiOjE3MDQ3NzEwNzYsImlhdCI6MTcwNDY4NDY3Nn0.FALf4zF0kIAf-pZPVmj8wChCDxGRaVuxQPHrzUy-Df0")
--header ("accept", "application/json;odata.metadata=minimal;odata.streaming=true, application/json;odata.metadata=minimal;odata.streaming=false, application/json;odata.metadata=minimal, application/json;odata.metadata=full;odata.streaming=true, application/json;odata.metadata=full;odata.streaming=false, application/json;odata.metadata=full, application/json;odata.metadata=none;odata.streaming=true, application/json;odata.metadata=none;odata.streaming=false, application/json;odata.metadata=none, application/json;odata.streaming=true, application/json;odata.streaming=false, application/json, application/xml, application/prs.odatatestxx-odata, text/plain, text/json")
$select
- Use to pinpoint specific data properties that should be included in the response from the request you have built. This expedites the transfer of information because you can minimize the unneeded information that can be returned in the response.
- You can use the select query on any field for a given endpoint if the field is not nested in an object. A nested object or property requires using the $expand query with $select.
- Separate multiple properties or fields within the $select clause using commas, not spaces.
Example | |
Desired outcome | Only return a list that contains the first name, last name, company name, and contact type name for contacts. |
Base URL | https://cloud-api.youraspire.com |
Resource | Contacts |
Query Parameter | $select |
Filter option(s) | FirstName,LastName,CompanyName,ContactTypeName |
Query | https://cloud-api.youraspire.com?$select=FirstName,LastName,CompanyName,ContactTypeName |
Example Response
[
{
"CompanyName": "Landscape, Inc.",
"ContactTypeName": "Customer",
"FirstName": "Aspire",
"LastName": "Company"
},
{
"CompanyName": "Landscape, Inc.",
"ContactTypeName": "Employee",
"FirstName": "Suzy",
"LastName": "Moon"
},
{
"CompanyName": "Busch Enterprises",
"ContactTypeName": "Customer",
"FirstName": "Robert",
"LastName": "Hugh"
},
{
"CompanyName": "National Art Corporation",
"ContactTypeName": "Customer",
"FirstName": "Kendra",
"LastName": "Farquod"
},
]
Code Sample
curl --request GET \
--url 'https://cloud-api.youraspire.com/Contacts?%24select=FirstName%2CLastName%2CCompanyName%2CContactTypeName' \
--header 'Authorization: eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJBc3BpcmVTeXN0ZW1JRCI6IjE1IiwiVXNlcklEIjoiNDg0OCIsIlVzZXJQZXJtaXNzaW9ucyI6IntcIlJvbGVJRFwiOjAsXCJSb2xlTmFtZVwiOm51bGwsXCJSZXF1aXJlZFwiOmZhbHNlLFwiUm9sZVZhbHVlXCI6MSxcIkFkZENvbnRhY3RcIjp0cnVlLFwiRWRpdE15Q29udGFjdHNcIjp0cnVlLFwiRWRpdEFsbENvbnRhY3RzXCI6dHJ1ZSxcIkRlbGV0ZUNvbnRhY3RcIjpmYWxzZSxcIkFkZEVtcGxveWVlSW5jaWRlbnRcIjp0cnVlLFwiRWRpdEFjY291bnRpbmdTeW5jSURcIjp0cnVlLFwiQnVsTbm93TW9kZVwiOnRydWUsXCJPcHBvcnR1bml0eUJyYW5jaE92ZXJyaWRlXCI6dHJ1mZhbHNlLFwiVXNlT3Bwb3J0dW5pdHlJdGVtRGlzcGxheU5hbWVPbkludm9pY2VcIjp0cnVlLFwiRW5hYmxlVmlzaXRDaGVja2xpc3RzXCI6dHJ1ZSxcIlRpbWVab25lXCI6XCJBbWVyaWNhL0NoaWNhZ29cIixcIkZpcnN0RGF5T2ZXZWVrXCI6XCJNb25kYXlcIixcIklub3ZhRW5hYmxlZFwiOnRydWUsXCJQVE9WaXNpYmxlXCI6dHJ1ZSxcIk1hcmtldGluZ1Byb0ludGVncmF0aW9uXCI6ZmFsc2UsXCJNYXJrZXRpbmdQcm9WZXJzaW9uXCI6bnVsbCxcIkVuYWJsZUF1dG9UaW1lQWNjZXB0YW5jZUNvbmZpZ1wiOmZhbHNlLFwiRW5hYmxlQXV0b1RpbWVBY2NlcHRhbmNlXCI6ZmFsc2UsXCJFbnRlcnByaXNlQWRtaW5UeXBlXCI6MH0iLCJGb3JiaWRkZW4iOiIiLCJuYmYiOjE3MDU0MjgyNTEsImV4cCI6MTcwNTUxNDY1MSwiaWF0IjoxNzA1NDI4MjUxfQ.Ray35HwIZrMEFZz_MmEAECDy75zr30sOGceKUSyldQw' \
--header 'accept: application/json;odata.metadata=minimal;odata.streaming=true, application/json;odata.metadata=minimal;odata.streaming=false, application/json;odata.metadata=minimal, application/json;odata.metadata=full;odata.streaming=true, application/json;odata.metadata=full;odata.streaming=false, application/json;odata.metadata=full, application/json;odata.metadata=none;odata.streaming=true, application/json;odata.metadata=none;odata.streaming=false, application/json;odata.metadata=none, application/json;odata.streaming=true, application/json;odata.streaming=false, application/json, application/xml, application/prs.odatatestxx-odata, text/plain, text/json'
$orderby
- Use to sort the order of your results using the data type of the chosen field or property.
- By default, the order of the returned value is sorted in ascending order.
- Use asc to determine that the order should be ascending and descending to determine that the order should be descending.
Example | |
Desired outcome | Retrieve a list of divisions sorted in ascending order by account number. |
Base URL | https://cloud-api.youraspire.com |
Resource | Divsions |
Query Parameter | $orderby |
Filter option | AccountNumber asc |
Query | https://cloud-api.youraspire.com?$orderby=AccountNumber asc |
Response Example
[
{
"DivisionID": 233,
"DivisionName": "Kendal Test Division",
"Active": true,
"DivisionCode": "dadasd",
"Indirect": true,
"WorkersCompID": null,
"WorkersCompName": null,
"AccountNumber": null,
"MaterialExpenseAccountNumber": null,
"EquipmentExpenseAccountNumber": null,
"SubExpenseAccountNumber": null,
"OtherExpenseAccountNumber": null
},
{
"DivisionID": 234,
"DivisionName": "Janitorial",
"Active": true,
"DivisionCode": "dadada",
"Indirect": false,
"WorkersCompID": 5,
"WorkersCompName": "Mowing",
"AccountNumber": null,
"MaterialExpenseAccountNumber": null,
"EquipmentExpenseAccountNumber": null,
"SubExpenseAccountNumber": null,
"OtherExpenseAccountNumber": null
},
{
"DivisionID": 253,
"DivisionName": "Christina's division",
"Active": true,
"DivisionCode": null,
"Indirect": false,
"WorkersCompID": 14,
"WorkersCompName": "Heavy Equipment",
"AccountNumber": null,
"MaterialExpenseAccountNumber": null,
"EquipmentExpenseAccountNumber": null,
"SubExpenseAccountNumber": null,
"OtherExpenseAccountNumber": null
},
{
"DivisionID": 273,
"DivisionName": "GPS Testing Division",
"Active": false,
"DivisionCode": "GPS",
"Indirect": false,
"WorkersCompID": null,
"WorkersCompName": null,
"AccountNumber": null,
"MaterialExpenseAccountNumber": null,
"EquipmentExpenseAccountNumber": null,
"SubExpenseAccountNumber": null,
"OtherExpenseAccountNumber": null
},
{
"DivisionID": 303,
"DivisionName": "Maintenance - Derek",
"Active": true,
"DivisionCode": "1313",
"Indirect": false,
"WorkersCompID": null,
"WorkersCompName": null,
"AccountNumber": null,
"MaterialExpenseAccountNumber": null,
"EquipmentExpenseAccountNumber": null,
"SubExpenseAccountNumber": null,
"OtherExpenseAccountNumber": null
}
}
Code Sample
curl --request GET \
--url 'https://cloud-api.youraspire.com/Divisions?%24orderby=AccountNumber%20asc' \
--header 'Authorization: eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJBc3BpcmVTeXN0ZW1JRCI6IjE1IiwiVXNlcklEIjoiNDg0OCIsIlVzZXJQZXJtaXNzaW9ucyI6IntcIlJvbGVJRFwiOjAsXCJSb2xlTmFtZVwiOm51bGwsXCJSZXF1aXJlZFwiOmZhbHNlLFwiUm9sZVZhbHVlXCI6MSxcIkFkZENvbnRhY3RcIjp0cnVlLFwiRWRpdE15Q29udGFjdHNcIjp0cnVlLFwiRWRpdEFsbENvbnRhY3RzXCI6dHJ1ZSxcIkRlbGV0ZUNvbnRhY3RcIjpmYWxzZSxcIkFkZEVtcGxveWVlSW5jaWRlbnRcIjp0cnVlLFwiRWRpdEFjY291bnRpbmdTeW5jSURcIjp0cnVlLFwiQnVsa0VtYWlsQ29udGFjdHNcIjp0cnVlLFwiU2VuZEN1c3RvbWVyUG9ydGFsSW52aXRhdGlvblwiOnRydWUsXCJJbXBvcnRDb250YWN0QW5kUHJvcGVydHlcIjp0cnVlLFwiQ29uZmlndXJlQ29udGFjdFJlcXVpcmVkRmllbGRzXCI6dHJ1ZSxcIkRlbGV0ZU1lcmdlQ29udGFjdHNcIjp0cnVlLFwiVXBkYXRlRW1wbG95ZWVQSU5cIjpmYWxzZSxcIkFkZFByb3BlcnR5XCI6dHJ1ZSxcIkVkaXRNeVByb3BlcnRpZXNcIjp0cnVlLFwiRWRpdEFsbFByb3BlcnRpZXNcIjp0cnVlLFwiRGVsZXRlUHJvcGVydHlcIjpmYWxzZSxcIkVkaXRRdWFsaXR5QXVkaXRzXCI6dHJ1ZSxcIlZpZXdQcm9wZXJ0aWVzXCI6dHJ1ZSxcIlZpZXdNeVByb3BlcnRpZXNcIjpmYWxzZSxcIkFkZE9wcG9ydHVuaXR5XCI6dHJ1ZSxcIkVkaXRNeU9wcG9ydHVuaXRpZXNcIjp0cnVlLFwiRWRpdEFsbE9wcG9ydHVuaXRpZXNcIjp0cnVlLFwiRGVsZXRlT3Bwb3J0dW5pdHlcIjp0cnVlLFwiQ2hhbmdlT3Bwb3J0dW5pdHlcIjp0cnVlLFwiVmlld1JlYWRPbmx5RXN0aW1hdGVzXCI6dHJ1ZSxcIlVuY2FuY2VsT3Bwb3J0dW5pdHlcIjp0cnVlLFwiSm9iRGFzaGJvYXJkXCI6dHJ1ZSxcIkltcG9ydEVzdGltYXRlXCI6dHJ1ZSxcIkVkaXRTZXJ2aWNlUGF5Q29kZXNcIjp0cnVlLFwiRGVsZXRlQWN0aXZpdHlcIjp0cnVlLFwiU3lzdGVtQWRtaW5cIjp0cnVlLFwiQnJhbmNoQWRtaW5cIjpmYWxzZSxcIlZpZXdSb3V0ZXNcIjp0cnVlLFwiTWFuYWdlT3Bwb3J0dW5pdHlUZW1wbGF0ZXNcIjp0cnVlLFwiTWFuYWdlR2VuZXJhbENvbmRpdGlvblRlbXBsYXRlc1wiOnRydWUsXCJNYWtlVmlzaXRDaGVja2xpc3RJdGVtc01hbmRhdG9yeVwiOnRydWUsXCJFZGl0RGFpbHlQbGFuUmVwb3J0XCI6dHJ1ZSxcIk1hcmtldGluZ1Byb1wiOnRydWUsXCJFeHBvcnRHcmlkc1wiOnRydWUsXCJFZGl0VGVtcGxhdGVzXCI6dHJ1ZSxcIk1hbmFnZVRlbXBsYXRlc1wiOnRydWUsXCJFZGl0RXN0aW1hdGVQcmljaW5nUGN0XCI6dHJ1ZSxcIkVkaXRFc3RpbWF0ZUl0ZW1zXCI6dHJ1ZSxcIkhvdXJSZWR1Y3Rpb25QY3RcIjoxMDAuMCxcIlByaWNlUmVkdWN0aW9uUGN0XCI6MTAwLjAsXCJVbmJhbGFuY2VkUGF5bWVudFNjaGVkdWxlXCI6dHJ1ZSxcIkFsbG93T25lVGltZUl0ZW1zXCI6dHJ1ZSxcIkFkZEl0ZW1zVG9DYXRhbG9nXCI6dHJ1ZSxcIkNoYW5nZVNlcnZpY2VJbnZvaWNlVHlwZU9uRml4ZWRQcmljZU9wZW5CaWxsaW5nXCI6dHJ1ZSxcIkFkanVzdEdlbmVyYWxDb25kaXRpb25zXCI6dHJ1ZSxcIkFkZE1vZGlmeVBheWNvZGVPdmVycmlkZXNcIjp0cnVlLFwiQXNOZWVkZWRFeGNlcHRpb25SZXBvcnRcIjp0cnVlLFwiTWFrZU9wcG9ydHVuaXR5U2VydmljZVZpc2l0Q2hlY2tsaXN0SXRlbXNNYW5kYXRvcnlcIjp0cnVlLFwiUHJvZHVjdGlvblwiOmZhbHNlLFwiVXBkYXRlSm9iXCI6ZmFsc2UsXCJDYW5jZWxXb3JrVGlja2V0XCI6dHJ1ZSxcIlNjaGVkdWxlQm9hcmRcIjp0cnVlLFwiU2NoZWR1bGVCb2FyZFJlYWRPbmx5XCI6dHJ1ZSxcIlJvdXRlT3B0aW1pemF0aW9uXCI6dHJ1ZSxcIlNjaGVkdWxlQW5FdmVudFwiOnRydWUsXCJBY2Nlc3NBdXRvVGltZUFjY2VwdGFuY2VSZXBvcnRzXCI6ZmFsc2UsXCJFZGl0Um91dGVzXCI6dHJ1ZSxcIkNyZXdMZWFkZXJcIjp0cnVlLFwiRXN0aW1hdGVcIjpmYWxzZSxcIlZpZXdBbGxUaW1lXCI6dHJ1ZSxcIk15UmVwb3J0c1wiOnRydWUsXCJBZHZhbmNlZFNlYXJjaFN5c3RlbUFkbWluXCI6ZmFsc2UsXCJIUkFkbWluXCI6dHJ1ZSxcIlNhbGVzTWFuYWdlclwiOnRydWUsXCJFZGl0UHJvcGVydHlCaWxsaW5nQ29udGFjdFwiOnRydWUsXCJVbmFwcHJvdmVSZWNlaXB0XCI6dHJ1ZSxcIkFwcHJvdmVUaW1lXCI6dHJ1ZSxcIkV4cG9ydFRpbWVcIjp0cnVlLFwiRWRpdFByaWNpbmdcIjp0cnVlLFwiQ2hvb3NlUmVwb3J0RXhwb3J0VHlwZVwiOnRydWUsXCJFZGl0QnVkZ2V0XCI6dHJ1ZSxcIlVuYXBwcm92ZVRpbWVcIjp0cnVlLFwiVmlld1JlYWRPbmx5UGF5cm9sbERhdGFcIjp0cnVlLFwiSW5vdmFMYWJvckJ1cmRlblRydWVVcFwiOnRydWUsXCJDcmVhdGVPdmVyVW5kZXJBZGp1c3RtZW50UmVjb3Jkc1wiOnRydWUsXCJDcmVhdGVSZWNlaXB0XCI6dHJ1ZSxcIkFwcHJvdmVSZWNlaXB0XCI6dHJ1ZSxcIkRlbGV0ZVJlY2VpcHRcIjp0cnVlLFwiQWRkUHVyY2hhc2VDcmVkaXRcIjp0cnVlLFwiU3VibWl0UmVjZWlwdFRvTGFuZHNjYXBlSHViXCI6dHJ1ZSxcIkFsbG93RXN0aW1hdGVOZWdhdGl2ZVF1YW50aXR5XCI6dHJ1ZSxcIkNyZWF0ZUludm9pY2VcIjp0cnVlLFwiVmlld0ludm9pY2luZ1wiOnRydWUsXCJFZGl0SW52b2ljaW5nXCI6dHJ1ZSxcIkRlbGV0ZUludm9pY2luZ1wiOnRydWUsXCJDcmVhdGVNaXNjSW52b2ljZVwiOmZhbHNlLFwiVmlld0FSTWFuYWdlbWVudFwiOnRydWUsXCJFZGl0QmlsbGluZ1wiOnRydWUsXCJWaWV3UHVyY2hhc2luZ1wiOnRydWUsXCJWaWV3UmV2ZW51ZVwiOnRydWUsXCJWaWV3UmVwb3J0c1wiOnRydWUsXCJDb21wbGV0ZVdvcmtUaWNrZXRcIjp0cnVlLFwiQXBwcm92ZVdvcmtUaWNrZXRcIjp0cnVlLFwiRGVsZXRlV29ya1RpY2tldFwiOnRydWUsXCJTd2FwQXNOZWVkZWRTZXJ2aWNlc1wiOnRydWUsXCJQYXJ0aWFsT2NjdXJcIjp0cnVlLFwiTW92ZVdvcmtUaWNrZXRDb3N0c1wiOnRydWUsXCJWaWV3T3Bwb3J0dW5pdGllc1wiOnRydWUsXCJWaWV3TXlPcHBvcnR1bml0aWVzXCI6ZmFsc2UsXCJXaW5Db250cmFjdFwiOnRydWUsXCJXaW5Xb3JrT3JkZXJcIjp0cnVlLFwiTG9zZU9wcG9ydHVuaXRpZXNcIjp0cnVlLFwiQWRkQ3JlZGl0TWVtb1wiOnRydWUsXCJUaWNrZXRCdWxrRW1haWxcIjp0cnVlLFwiRWRpdEJ1ZGdldGVkSG91ckFuZFJldmVudWVcIjp0cnVlLFwiUmVwb3J0QWNjZXNzXCI6e30sXCJNb2RpZnlTZW50SW52b2ljZXNcIjp0cnVlLFwiQWRkQ3Jld0xlYWRlckNvbnRhY3RcIjp0cnVlLFwiT3ZlcnJpZGVUb3RhbENvc3RcIjp0cnVlLFwiRWRpdEVhcm5lZFJldmVudWVcIjp0cnVlLFwiVmlld0tQSU92ZXJoZWFkUmVjb3ZlcnlcIjp0cnVlLFwiVmlld0tQSUNsaWVudE1hbmFnZW1lbnRcIjp0cnVlLFwiVmlld0tQSVByb2ZpdExvc3NcIjp0cnVlLFwiVmlld0tQSUZvcmVjYXN0XCI6dHJ1ZSxcIlZpZXdLUElDb21wbGV0ZWRMYWJvckVmZmljaWVuY3lcIjp0cnVlLFwiVmlld0tQSVNhbGVzU2NvcmVDYXJkXCI6dHJ1ZSxcIlZpZXdTYWxlc1BpcGVsaW5lSW5zaWdodFwiOnRydWUsXCJWaWV3Q3VzdG9tZXJJc3N1ZXNJbnNpZ2h0XCI6dHJ1ZSxcIkNsb3NlTW9udGhcIjp0cnVlLFwiQXBwcm92ZUVxdWlwbWVudFwiOnRydWUsXCJEaXNwb3NlRXF1aXBtZW50XCI6dHJ1ZSxcIkRlbGV0ZUVxdWlwbWVudFwiOnRydWUsXCJFcXVpcG1lbnRBZG1pblwiOnRydWUsXCJNYXJrRXF1aXBtZW50SW5TZXJ2aWNlXCI6dHJ1ZSxcIk1hcmtFcXVpcG1lbnRPdXRPZlNlcnZpY2VcIjp0cnVlLFwiUHVyY2hhc2VFcXVpcG1lbnRcIjp0cnVlLFwiUmVxdWVzdEVxdWlwbWVudFwiOnRydWUsXCJWaWV3RXF1aXBtZW50XCI6dHJ1ZSxcIkVzdGltYXRlQ3VzdG9tQ29sdW1uXCI6dHJ1ZSxcIlRyaWdnZXJBdXRvRXhwZW5zZUNyZWF0aW9uXCI6dHJ1ZSxcIlJvdXRlU2NoZWR1bGluZ1wiOnRydWUsXCJBZGRGdWVsUmF0ZVwiOnRydWUsXCJGdWVsQ29zdFJlcG9ydFwiOnRydWUsXCJNYW5hZ2VDdXN0b21GaWVsZHNcIjp0cnVlLFwiUHJvY2Vzc0VsZWN0cm9uaWNQYXltZW50c1wiOnRydWUsXCJWb2lkRWxlY3Ryb25pY1BheW1lbnRzXCI6dHJ1ZSxcIlJlZnVuZEVsZWN0cm9uaWNQYXltZW50c1wiOnRydWUsXCJFeHBpcmluZ0VsZWN0cm9uaWNQYXltZW50TWV0aG9kc0FsZXJ0c1wiOnRydWUsXCJSZWplY3RlZEVsZWN0cm9uaWNQYXltZW50c0FsZXJ0c1wiOnRydWUsXCJBbm51YWxSZW5ld2Fsc1wiOnRydWUsXCJWaWV3Q29tcGFuaWVzXCI6dHJ1ZSxcIkVkaXRDb21wYW5pZXNcIjp0cnVlLFwiQWRkQ29tcGFuaWVzXCI6dHJ1ZSxcIkNhbmNlbENvbnRyYWN0XCI6dHJ1ZSxcIkNhbmNlbFdvcmtPcmRlclwiOnRydWUsXCJNb2RpZnlTT1ZBZnRlck9wcG9ydHVuaXR5SXNXb25cIjp0cnVlLFwiQ2hhbmdlQXNzaWduZWRQcm9wZXJ0eUJyYW5jaFwiOnRydWUsXCJNYW5hZ2VVc2VyUm9sZXNcIjp0cnVlLFwiRWRpdEVxdWlwbWVudENvc3RBbmRIb3Vyc1wiOnRydWUsXCJDcmVhdGVFcXVpcG1lbnRJbnNwZWN0aW9uc1wiOnRydWUsXCJSZWNlaXZlUmVjZWlwdFwiOnRydWUsXCJNYW5hZ2VOb3RpZmljYXRpb25zU3lzdGVtXCI6dHJ1ZSxcIk1hbmFnZU5vdGlmaWNhdGlvbnNCcmFuY2hcIjp0cnVlLFwiUmVwb3J0V2ViRGVzaWduZXJcIjp0cnVlLFwiVmlld0ludmVudG9yeUxvY2F0aW9uc1wiOnRydWUsXCJFZGl0SW52ZW50b3J5TG9jYXRpb25zXCI6dHJ1ZSxcIlJvbGVQZXJtaXNzaW9uXCI6W10sXCJMb2NhbEJyYW5jaEFkbWluXCI6ZmFsc2UsXCJIYXNBbnlSZXBvcnRBY2Nlc3NcIjpmYWxzZX0iLCJBc3BpcmVTeXN0ZW1TZXR0aW5ncyI6IntcIkNvbXBhbnlOYW1lXCI6XCJJbmNyZWRpc2NhcGUgVUFUXCIsXCJFc3RpbWF0ZUxpY2Vuc2VcIjp0cnVlLFwiVGlja2V0TWFuYWdlbWVudExpY2Vuc2VcIjp0cnVlLFwiRXN0aW1hdGluZ1N0YWdpbmdcIjpmYWxzZSxcIkludm9pY2luZ0xpY2Vuc2VcIjp0cnVlLFwiQVJNYW5hZ2VtZW50TGljZW5zZVwiOnRydWUsXCJCaWxsaW5nRW1haWxGcm9tQWNjb3VudE93bmVyXCI6ZmFsc2UsXCJQYXljaGV4SW5jbHVkZURhdGVzXCI6dHJ1ZSxcIlJlcXVpcmVVbmlxdWVWZW5kb3JJbnZvaWNlTnVtYmVyXCI6ZmFsc2UsXCJSZXN0cmljdEVkaXRpbmdFbXBsb3llZXNcIjpmYWxzZSxcIkNyZWF0ZVByb3BlcnR5RnJvbUNvbnRhY3RcIjp0cnVlLFwiRW5hYmxlRWxlY3Ryb25pY1NpZ25hdHVyZXNcIjp0cnVlLFwiTWFzdGVyU3lzdGVtXCI6ZmFsc2UsXCJTbm93TW9kZVwiOnRydWUsXCJPcHBvcnR1bml0eUJyYW5jaE92ZXJyaWRlXCI6dHJ1ZSxcIlJvdW5kQ2xvY2tJbk91dFRpbWVzXCI6ZmFsc2UsXCJPTEFQUGl2b3RFbmFibGVkXCI6dHJ1ZSxcIkRpc2FibGVBdXRvbWF0aWNBcHByb3ZhbFwiOnRydWUsXCJEaXNhYmxlTW9iaWxlQ3Jld01hbmFnZW1lbnRcIjpmYWxzZSxcIkRpc2FibGVEZWxldGlvbk9mV29ya1RpY2tldHNcIjpmYWxzZSxcIkFsbG93U3ViVG9Mb2dpblwiOnRydWUsXCJIaWRlU2NoZWR1bGVQcm9ncmVzc0JhclwiOmZhbHNlLFwiV2Fybk9uRWFybHlMdW5jaENsb2NraW5cIjoyLFwiQ2FsaWZvcm5pYVRpbWVQcm9tcHRzXCI6ZmFsc2UsXCJJbnZvaWNpbmdBc3Npc3RhbnRSZXF1aXJlQmlsbGluZ0NvbXBhbnlcIjp0cnVlLFwiRW5mb3JjZUJyYW5jaEFkbWluQWRtaW5pc3RyYXRpb25TZWN1cml0eVwiOnRydWUsXCJPVENhbGN1bGF0aW9uXCI6XCJPdmVycmlkZSBQYXljb2RlXCIsXCJFcXVpcG1lbnRSZWFkaW5nQ2xvY2tPdXRQcm9tcHRcIjpcIkVuZCBvZiBEYXlcIixcIlNob3dOZXRHcm9zc01hcmdpbk9uRXN0aW1hdGluZ1NjcmVlblwiOnRydWUsXCJTaG93T25seUdyb3NzTWFyZ2lub25Fc3RpbWF0aW5nU2NyZWVuXCI6ZmFsc2UsXCJDcmVhdGVFcXVpcG1lbnRSZWFkaW5nc1wiOnRydWUsXCJJbmNsdWRlRHJpdmVUaW1lV2hlbkxvZ2dpbmdFcXVpcG1lbnRDcmV3TW9iaWxlXCI6dHJ1ZSxcIkVuYWJsZU5lZ2F0aXZlQ2hhbmdlT3JkZXJzXCI6dHJ1ZSxcIkVuYWJsZUN1c3RvbWVyUG9ydGFsXCI6dHJ1ZSxcIkRlZmF1bHRHRU9QZXJpbWV0ZXJcIjo1MDAuMCxcIkVuYWJsZUFzcGlyZUdQU0ludGVncmF0aW9uXCI6dHJ1ZSxcIkVuYWJsZUVxdWlwbWVudE1vZHVsZUFkZE9uXCI6dHJ1ZSxcIkdQU0ludGVncmF0aW9uUHJvdmlkZXJcIjozLFwiRW5hYmxlRWxlY3Ryb25pY1BheW1lbnRzXCI6dHJ1ZSxcIkVuYWJsZVNpdGVPbmVcIjpmYWxzZSxcIkJyZWFrVGltZVwiOjAuNSxcIlBheWNoZXhFeHBvcnRGb3JtYXRcIjpcIkRlZmF1bHQgQ1NWXCIsXCJFbmFibGVQYXJ0aWFsVGltZU9uU3ViUG9ydGFsXCI6dHJ1ZSxcIkVuYWJsZVBhcnRpYWxUaW1lT25DcmV3TW9iaWxlXCI6dHJ1ZSxcIkVuYWJsZUxhbmRzY2FwZUh1YkludGVncmF0aW9uXCI6dHJ1ZSxcIkRpc3BsYXlUYXhPbkVzdGltYXRlXCI6dHJ1ZSxcIkxpbmtTY2hlZHVsZW9mVmFsdWV0b1NlcnZpY2VCeURlZmF1bHRcIjpmYWxzZSxcIkVuYWJsZVdlYXRoZXJtYXRpY0ludGVncmF0aW9uXCI6dHJ1ZSxcIkFkdmFuY2VkU2VhcmNoU2VsZWN0VG9wTnVtYmVyXCI6NTAwMCxcIkVuYWJsZU92ZXJVbmRlckFkanVzdG1lbnRzXCI6dHJ1ZSxcIkRlZmF1bHREaXZpc2lvbklERm9yV29ya09yZGVyc1wiOjAsXCJEZWZhdWx0Rm9udFwiOlwiVmVyZGFuYSxzYW5zLXNlcmlmXCIsXCJEZWZhdWx0Rm9udFNpemVcIjpcIjE0LjAwXCIsXCJDcmV3TGVhZGVyUm9sZUlEXCI6MTIwMixcIlJlcXVpcmVOb09wZW5JbnZvaWNlc0NoZWNrXCI6dHJ1ZSxcIlByb2R1Y3RUaWVyXCI6MCxcIkNhbkFjY2Vzc0FQSXNcIjpmYWxzZSxcIkhhc0ZhY2lhbFJlY1wiOmZhbHNlLFwiRW5hYmxlVGFrZW9mZkludGVncmF0aW9uXCI6dHJ1ZSxcIlRha2VvZmZJbnRlZ3JhdGlvblR5cGVcIjo3LFwiRGVmYXVsdFByb3BlcnR5VGFrZW9mZlByb3ZpZGVyXCI6NCxcIkRlZmF1bHRFc3RpbWF0ZVRha2VvZmZQcm92aWRlclwiOjQsXCJFbmFibGVXZWJSZXBvcnREZXNpZ25lclwiOmZhbHNlLFwiQXp1Z2FDdXN0b21lcklEXCI6MTA1OSxcIkVuYWJsZUNyZXdNZW1iZXJDbG9ja0luV2l0aG91dENyZXdMZWFkZXJcIjpmYWxzZSxcIkVuYWJsZUVPTVJlcG9ydFwiOmZhbHNlLFwiVXNlT3Bwb3J0dW5pdHlJdGVtRGlzcGxheU5hbWVPbkludm9pY2VcIjp0cnVlLFwiRW5hYmxlVmlzaXRDaGVja2xpc3RzXCI6dHJ1ZSxcIlRpbWVab25lXCI6XCJBbWVyaWNhL0NoaWNhZ29cIixcIkZpcnN0RGF5T2ZXZWVrXCI6XCJNb25kYXlcIixcIklub3ZhRW5hYmxlZFwiOnRydWUsXCJQVE9WaXNpYmxlXCI6dHJ1ZSxcIk1hcmtldGluZ1Byb0ludGVncmF0aW9uXCI6ZmFsc2UsXCJNYXJrZXRpbmdQcm9WZXJzaW9uXCI6bnVsbCxcIkVuYWJsZUF1dG9UaW1lQWNjZXB0YW5jZUNvbmZpZ1wiOmZhbHNlLFwiRW5hYmxlQXV0b1RpbWVBY2NlcHRhbmNlXCI6ZmFsc2UsXCJFbnRlcnByaXNlQWRtaW5UeXBlXCI6MH0iLCJGb3JiaWRkZW4iOiIiLCJuYmYiOjE3MDU0MjgyNTEsImV4cCI6MTcwNTUxNDY1MSwiaWF0IjoxNzA1NDI4MjUxfQ.Ray35HwIZrMEFZz_MmEAECDy75zr30sOGceKUSyldQw' \
--header 'accept: application/json;odata.metadata=minimal;odata.streaming=true, application/json;odata.metadata=minimal;odata.streaming=false, application/json;odata.metadata=minimal, application/json;odata.metadata=full;odata.streaming=true, application/json;odata.metadata=full;odata.streaming=false, application/json;odata.metadata=full, application/json;odata.metadata=none;odata.streaming=true, application/json;odata.metadata=none;odata.streaming=false, application/json;odata.metadata=none, application/json;odata.streaming=true, application/json;odata.streaming=false, application/json, application/xml, application/prs.odatatestxx-odata, text/plain, text/json'
Pagination query options
Use pagination query options to limit the amount of data that is returned at one time.
$top, $skip, and $limit require the input of integers only.
- $limit - can only be used with $pageNumber to limit the amount of items returned on a page (page size). By default, the limit is 1000 records per page.
- $pageNumber - go to a specific results page number.
- $top - limit number of items returned. It must be a positive integer.
- $skip - skip the number of objects before retrieving the result. It must be a positive integer.
$top
Use to limit the number of results returned after sending the request by specifying the maximum number of records to include at the top of the response. Use independently or in conjunction with the $skip query option.
- Integers only.
- Use both $top and $skip are used in conjunction.
Example | |
Desired outcome | Retrieve a list of the first three contact records. |
Base URL | https://cloud-api.youraspire.com |
Resource | Contacts |
Query Parameter | $top |
Filter option | 3 |
Query | https://cloud-api.youraspire.com?$top=3 |
Example Response
[
{
"ContactID": 22536,
"CompanyID": 7885,
"CompanyName": "Landscape, Inc.",
"ContactTypeID": 1055,
"ContactTypeName": "Customer",
"OfficeAddress": {
"AddressID": 34195,
"AddressLine1": "Line 1",
"AddressLine2": "Line 2",
"City": "Saint Peters",
"StateProvinceCode": "MO",
"ZipCode": "63376",
"CreatedByUserId": 3979,
"CreatedOn": "2023-04-15T04:30:02.61Z",
"LastModifiedByUserId": 3316,
"LastModifiedOn": "2023-04-17T04:30:02.61Z"
},
"HomeAddress": {
"AddressID": 44787,
"AddressLine1": "Line 1",
"AddressLine2": "Line 2",
"City": "Sarajevo",
"StateProvinceCode": null,
"ZipCode": "71000",
"CreatedByUserId": 3979,
"CreatedOn": "2023-04-15T04:30:02.61Z",
"LastModifiedByUserId": 3316,
"LastModifiedOn": "2023-04-17T04:30:02.61Z"
},
"BranchID": 50,
"BranchName": "St. Louis",
"OwnerContactID": 22597,
"OwnerContactName": "Bill Bags",
"Salutation": null,
"FirstName": "Aspire",
"LastName": "Customer",
"ProspectRating": "2",
"ProspectRatingName": "Warm",
"Title": "Ownerr",
"Email": "user@email.com",
"MobilePhone": null,
"OfficePhone": "(314) 954-7519",
"HomePhone": "(314) 954-7519",
"Fax": null,
"Notes": "Testing Save in Mobile interface on 3/20/2017\r\nkendal.walton@youraspire.com",
"Active": true,
"CreatedDateTime": null,
"CreatedByUserID": null,
"CreatedByUserName": null,
"EmployeeNumber": "1164",
"Website": null,
"EmployeePin": "9219009",
"AccountingSyncID": "1",
"ExternalContactReference": "2",
"TerminationDate": "2020-04-21T00:00:00Z",
"HRNotes": null,
"DefaultWorkersCompID": 13,
"DefaultWorkersCompName": "Brick Laying",
"DefaultWorkersCompStateProvinceCode": "AL",
"UserID": 3197,
"CrewSize": null,
"PromptForCrewSize": false,
"SubCrewLeaderContactID": null,
"PayScheduleID": 38,
"ModifiedDate": "2023-12-21T11:22:21.49Z",
"ContactTags": []
},
{
"ContactID": 22537,
"CompanyID": 7885,
"CompanyName": "Landscape, Inc.",
"ContactTypeID": 1056,
"ContactTypeName": "Employee",
"OfficeAddress": {
"AddressID": 34196,
"AddressLine1": "",
"AddressLine2": "",
"City": "Saint Peters",
"StateProvinceCode": "MO",
"ZipCode": "63376",
"CreatedByUserId": 3979,
"CreatedOn": "2023-04-15T04:30:02.61Z",
"LastModifiedByUserId": null,
"LastModifiedOn": null
},
"HomeAddress": null,
"BranchID": 50,
"BranchName": "St. Louis",
"OwnerContactID": 22597,
"OwnerContactName": "Bill Bags",
"Salutation": "Ms.",
"FirstName": "Suzy",
"LastName": "April",
"ProspectRating": "2",
"ProspectRatingName": "Warm",
"Title": "Account Manager",
"Email": "",
"MobilePhone": "",
"OfficePhone": "",
"HomePhone": "",
"Fax": "",
"Notes": "",
"Active": false,
"CreatedDateTime": "2016-03-01T16:47:30.977Z",
"CreatedByUserID": null,
"CreatedByUserName": null,
"EmployeeNumber": "",
"Website": "",
"EmployeePin": "",
"AccountingSyncID": "",
"ExternalContactReference": null,
"TerminationDate": null,
"HRNotes": null,
"DefaultWorkersCompID": null,
"DefaultWorkersCompName": null,
"DefaultWorkersCompStateProvinceCode": null,
"UserID": null,
"CrewSize": null,
"PromptForCrewSize": false,
"SubCrewLeaderContactID": null,
"PayScheduleID": null,
"ModifiedDate": null,
"ContactTags": []
},
{
"ContactID": 22538,
"CompanyID": 7671,
"CompanyName": "Busch Enterprises",
"ContactTypeID": 1055,
"ContactTypeName": "Customer",
"OfficeAddress": {
"AddressID": 30537,
"AddressLine1": "1200 treet",
"AddressLine2": null,
"City": "St. Louis",
"StateProvinceCode": "MO",
"ZipCode": "63118",
"CreatedByUserId": 3979,
"CreatedOn": "2023-04-15T04:30:02.61Z",
"LastModifiedByUserId": null,
"LastModifiedOn": null
},
"HomeAddress": {
"AddressID": 41137,
"AddressLine1": null,
"AddressLine2": null,
"City": null,
"StateProvinceCode": null,
"ZipCode": null,
"CreatedByUserId": 3979,
"CreatedOn": "2023-04-15T04:30:02.61Z",
"LastModifiedByUserId": null,
"LastModifiedOn": null
},
"BranchID": 50,
"BranchName": "St. Louis",
"OwnerContactID": 23214,
"OwnerContactName": "My Name",
"Salutation": null,
"FirstName": "Robert",
"LastName": "Hugh",
"ProspectRating": "2",
"ProspectRatingName": "Warm",
"Title": "Property Manager",
"Email": "Robert.H@gmail.comx",
"MobilePhone": "",
"OfficePhone": "314-555-6656",
"HomePhone": null,
"Fax": null,
"Notes": null,
"Active": true,
"CreatedDateTime": "2016-03-01T16:47:30.993Z",
"CreatedByUserID": null,
"CreatedByUserName": null,
"EmployeeNumber": "",
"Website": "stlouis.cardinals.mlb.com",
"EmployeePin": "",
"AccountingSyncID": "",
"ExternalContactReference": "",
"TerminationDate": null,
"HRNotes": null,
"DefaultWorkersCompID": null,
"DefaultWorkersCompName": null,
"DefaultWorkersCompStateProvinceCode": null,
"UserID": null,
"CrewSize": null,
"PromptForCrewSize": false,
"SubCrewLeaderContactID": null,
"PayScheduleID": null,
"ModifiedDate": "2023-11-22T16:28:32.217Z",
"ContactTags": []
}
]
Code Sample
curl --request GET \
--url 'https://cloud-api.youraspire.com/Contacts?%24top=3' \
--header 'Authorization: eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJBc3BpcmVTeXN0ZW1JRCI6IjE1IiwiVXNlcklEIjoiNDg0OCIsIlVzZXJQZXJtaXNzaW9ucyI6IntcIlJvbGVJRFwiOjAsXCJSb2xlTmFtZVwiOm51bGwsXCJSZXF1aXJlZFwiOmZhbHNlLFwiUm9sZVZhbHVlXCI6MSxcIkFkZENvbnRhY3RcIjp0cnVlLFwiRWRpdE15Q29udGFjdHNcIjp0cnVlLFwiRWRpdEFsbENvbnRhY3RzXCI6dHJ1ZSxcIkRlbGV0ZUNvbnRhY3RcIjpmYWxzZSxcIkFkZEVtcGxveWVlSW5jaWRlbnRcIjp0cnVlLFwiRWRpdEFjY291bnRpbmdTeW5jSURcIjp0cnVlLFwiQnVsa0VtYWlsQ29udGFjdHNcIjp0cnVlLFwiU2VuZEN1c3RvbWVyUG9ydGFsSW52aXRhdGlvblwiOnRydWUsXCJJbXBvcnRDb250YWN0QW5kUHJvcGVydHlcIjp0cnVlLFwiQ29uZmlndXJlQ29udGFjdFJlcXVpcmVkRmllbGRzXCI6dHJ1ZSxcIkRlbGV0ZU1lcmdlQ29udGFjdHNcIjp0cnVlLFwiVXBkYXRlRW1wbG95ZWVQSU5cIjpmYWxzZSxcIkFkZFByb3BlcnR5XCI6dHJ1ZSxcIkVkaXRNeVByb3BlcnRpZXNcIjp0cnVlLFwiRWRpdEFsbFByb3BlcnRpZXNcIjp0cnVlLFwiRGVsZXRlUHJvcGVydHlcIjpmYWxzZSxcIkVkaXRRdWFsaXR5QXVkaXRzXCI6dHJ1ZSxcIlZpZXdQcm9wZXJ0aWVzXCI6dHJ1ZSxcIlZpZXdNeVByb3BlcnRpZXNcIjpmYWxzZSxcIkFkZE9wcG9ydHVuaXR5XCI6dHJ1ZSxcIkVkaXRNeU9wcG9ydHVuaXRpZXNcIjp0cnVlLFwiRWRpdEFsbE9wcG9ydHVuaXRpZXNcIjp0cnVlLFwiRGVsZXRlT3Bwb3J0dW5pdHlcIjp0cnVlLFwiQ2hhbmdlT3Bwb3J0dW5pdHlcIjp0cnVlLFwiVmlld1JlYWRPbmx5RXN0aW1hdGVzXCI6dHJ1ZSxcIlVuY2FuY2VsT3Bwb3J0dW5pdHlcIjp0cnVlLFwiSm9iRGFzaGJvYXJkXCI6dHJ1ZSxcIkltcG9ydEVzdGltYXRlXCI6dHJ1ZSxcIkVkaXRTZXJ2aWNlUGF5Q29kZXNcIjp0cnVlLFwiRGVsZXRlQWN0aXZpdHlcIjp0cnVlLFwiU3lzdGVtQWRtaW5cIjp0cnVlLFwiQnJhbmNoQWRtaW5cIjpmYWxzZSxcIlZpZXdSb3V0ZXNcIjp0cnVlLFwiTWFuYWdlT3Bwb3J0dW5pdHlUZW1wbGF0ZXNcIjp0cnVlLFwiTWFuYWdlR2VuZXJhbENvbmRpdGlvblRlbXBsYXRlc1wiOnRydWUsXCJNYWtlVmlzaXRDaGVja2xpc3RJdGVtc01hbmRhdG9yeVwiOnRydWUsXCJFZGl0RGFpbHlQbGFuUmVwb3J0XCI6dHJ1ZSxcIk1hcmtldGluZ1Byb1wiOnRydWUsXCJFeHBvcnRHcmlkc1wiOnRydWUsXCJFZGl0VGVtcGxhdGVzXCI6dHJ1ZSxcIk1hbmFnZVRlbXBsYXRlc1wiOnRydWUsXCJFZGl0RXN0aW1hdGVQcmljaW5nUGN0XCI6dHJ1ZSxcIkVkaXRFc3RpbWF0ZUl0ZW1zXCI6dHJ1ZSxcIkhvdXJSZWR1Y3Rpb25QY3RcIjoxMDAuMCxcIlByaWNlUmVkdWN0aW9uUGN0XCI6MTAwLjAsXCJVbmJhbGFuY2VkUGF5bWVudFNjaGVkdWxlXCI6dHJ1ZSxcIkFsbG93T25lVGltZUl0ZW1zXCI6dHJ1ZSxcIkFkZEl0ZW1zVG9DYXRhbG9nXCI6dHJ1ZSxcIkNoYW5nZVNlcnZpY2VJbnZvaWNlVHlwZU9uRml4ZWRQcmljZU9wZW5CaWxsaW5nXCI6dHJ1ZSxcIkFkanVzdEdlbmVyYWxDb25kaXRpb25zXCI6dHJ1ZSxcIkFkZE1vZGlmeVBheWNvZGVPdmVycmlkZXNcIjp0cnVlLFwiQXNOZWVkZWRFeGNlcHRpb25SZXBvcnRcIjp0cnVlLFwiTWFrZU9wcG9ydHVuaXR5U2VydmljZVZpc2l0Q2hlY2tsaXN0SXRlbXNNYW5kYXRvcnlcIjp0cnVlLFwiUHJvZHVjdGlvblwiOmZhbHNlLFwiVXBkYXRlSm9iXCI6ZmFsc2UsXCJDYW5jZWxXb3JrVGlja2V0XCI6dHJ1ZSxcIlNjaGVkdWxlQm9hcmRcIjp0cnVlLFwiU2NoZWR1bGVCb2FyZFJlYWRPbmx5XCI6dHJ1ZSxcIlJvdXRlT3B0aW1pemF0aW9uXCI6dHJ1ZSxcIlNjaGVkdWxlQW5FdmVudFwiOnRydWUsXCJBY2Nlc3NBdXRvVGltZUFjY2VwdGFuY2VSZXBvcnRzXCI6ZmFsc2UsXCJFZGl0Um91dGVzXCI6dHJ1ZSxcIkNyZXdMZWFkZXJcIjp0cnVlLFwiRXN0aW1hdGVcIjpmYWxzZSxcIlZpZXdBbGxUaW1lXCI6dHJ1ZSxcIk15UmVwb3J0c1wiOnRydWUsXCJBZHZhbmNlZFNlYXJjaFN5c3RlbUFkbWluXCI6ZmFsc2UsXCJIUkFkbWluXCI6dHJ1ZSxcIlNhbGVzTWFuYWdlclwiOnRydWUsXCJFZGl0UHJvcGVydHlCaWxsaW5nQ29udGFjdFwiOnRydWUsXCJVbmFwcHJvdmVSZWNlaXB0XCI6dHJ1ZSxcIkFwcHJvdmVUaW1lXCI6dHJ1ZSxcIkV4cG9ydFRpbWVcIjp0cnVlLFwiRWRpdFByaWNpbmdcIjp0cnVlLFwiQ2hvb3NlUmVwb3J0RXhwb3J0VHlwZVwiOnRydWUsXCJFZGl0QnVkZ2V0XCI6dHJ1ZSxcIlVuYXBwcm92ZVRpbWVcIjp0cnVlLFwiVmlld1JlYWRPbmx5UGF5cm9sbERhdGFcIjp0cnVlLFwiSW5vdmFMYWJvckJ1cmRlblRydWVVcFwiOnRydWUsXCJDcmVhdGVPdmVyVW5kZXJBZGp1c3RtZW50UmVjb3Jkc1wiOnRydWUsXCJDcmVhdGVSZWNlaXB0XCI6dHJ1ZSxcIkFwcHJvdmVSZWNlaXB0XCI6dHJ1ZSxcIkRlbGV0ZVJlY2VpcHRcIjp0cnVlLFwiQWRkUHVyY2hhc2VDcmVkaXRcIjp0cnVlLFwiU3VibWl0UmVjZWlwdFRvTGFuZHNjYXBlSHViXCI6dHJ1ZSxcIkFsbG93RXN0aW1hdGVOZWdhdGl2ZVF1YW50aXR5XCI6dHJ1ZSxcIkNyZWF0ZUludm9pY2VcIjp0cnVlLFwiVmlld0ludm9pY2luZ1wiOnRydWUsXCJFZGl0SW52b2ljaW5nXCI6dHJ1ZSxcIkRlbGV0ZUludm9pY2luZ1wiOnRydWUsXCJDcmVhdGVNaXNjSW52b2ljZVwiOmZhbHNlLFwiVmlld0FSTWFuYWdlbWVudFwiOnRydWUsXCJFZGl0QmlsbGluZ1wiOnRydWUsXCJWaWV3UHVyY2hhc2luZ1wiOnRydWUsXCJWaWV3UmV2ZW51ZVwiOnRydWUsXCJWaWV3UmVwb3J0c1wiOnRydWUsXCJDb21wbGV0ZVdvcmtUaWNrZXRcIjp0cnVlLFwiQXBwcm92ZVdvcmtUaWNrZXRcIjp0cnVlLFwiRGVsZXRlV29ya1RpY2tldFwiOnRydWUsXCJTd2FwQXNOZWVkZWRTZXJ2aWNlc1wiOnRydWUsXCJQYXJ0aWFsT2NjdXJcIjp0cnVlLFwiTW92ZVdvcmtUaWNrZXRDb3N0c1wiOnRydWUsXCJWaWV3T3Bwb3J0dW5pdGllc1wiOnRydWUsXCJWaWV3TXlPcHBvcnR1bml0aWVzXCI6ZmFsc2UsXCJXaW5Db250cmFjdFwiOnRydWUsXCJXaW5Xb3JrT3JkZXJcIjp0cnVlLFwiTG9zZU9wcG9ydHVuaXRpZXNcIjp0cnVlLFwiQWRkQ3JlZGl0TWVtb1wiOnRydWUsXCJUaWNrZXRCdWxrRW1haWxcIjp0cnVlLFwiRWRpdEJ1ZGdldGVkSG91ckFuZFJldmVudWVcIjp0cnVlLFwiUmVwb3J0QWNjZXNzXCI6e30sXCJNb2RpZnlTZW50SW52b2ljZXNcIjp0cnVlLFwiQWRkQ3Jld0xlYWRlckNvbnRhY3RcIjp0cnVlLFwiT3ZlcnJpZGVUb3RhbENvc3RcIjp0cnVlLFwiRWRpdEVhcm5lZFJldmVudWVcIjp0cnVlLFwiVmlld0tQSU92ZXJoZWFkUmVjb3ZlcnlcIjp0cnVlLFwiVmlld0tQSUNsaWVudE1hbmFnZW1lbnRcIjp0cnVlLFwiVmlld0tQSVByb2ZpdExvc3NcIjp0cnVlLFwiVmlld0tQSUZvcmVjYXN0XCI6dHJ1ZSxcIlZpZXdLUElDb21wbGV0ZWRMYWJvckVmZmljaWVuY3lcIjp0cnVlLFwiVmlld0tQSVNhbGVzU2NvcmVDYXJkXCI6dHJ1ZSxcIlZpZXdTYWxlc1BpcGVsaW5lSW5zaWdodFwiOnRydWUsXCJWaWV3Q3VzdG9tZXJJc3N1ZXNJbnNpZ2h0XCI6dHJ1ZSxcIkNsb3NlTW9udGhcIjp0cnVlLFwiQXBwcm92ZUVxdWlwbWVudFwiOnRydWUsXCJEaXNwb3NlRXF1aXBtZW50XCI6dHJ1ZSxcIkRlbGV0ZUVxdWlwbWVudFwiOnRydWUsXCJFcXVpcG1lbnRBZG1pblwiOnRydWUsXCJNYXJrRXF1aXBtZW50SW5TZXJ2aWNlXCI6dHJ1ZSxcIk1hcmtFcXVpcG1lbnRPdXRPZlNlcnZpY2VcIjp0cnVlLFwiUHVyY2hhc2VFcXVpcG1lbnRcIjp0cnVlLFwiUmVxdWVzdEVxdWlwbWVudFwiOnRydWUsXCJWaWV3RXF1aXBtZW50XCI6dHJ1ZSxcIkVzdGltYXRlQ3VzdG9tQ29sdW1uXCI6dHJ1ZSxcIlRyaWdnZXJBdXRvRXhwZW5zZUNyZWF0aW9uXCI6dHJ1ZSxcIlJvdXRlU2NoZWR1bGluZ1wiOnRydWUsXCJBZGRGdWVsUmF0ZVwiOnRydWUsXCJGdWVsQ29zdFJlcG9ydFwiOnRydWUsXCJNYW5hZ2VDdXN0b21GaWVsZHNcIjp0cnVlLFwiUHJvY2Vzc0VsZWN0cm9uaWNQYXltZW50c1wiOnRydWUsXCJWb2lkRWxlY3Ryb25pY1BheW1lbnRzXCI6dHJ1ZSxcIlJlZnVuZEVsZWN0cm9uaWNQYXltZW50c1wiOnRydWUsXCJFeHBpcmluZ0VsZWN0cm9uaWNQYXltZW50TWV0aG9kc0FsZXJ0c1wiOnRydWUsXCJSZWplY3RlZEVsZWN0cm9uaWNQYXltZW50c0FsZXJ0c1wiOnRydWUsXCJBbm51YWxSZW5ld2Fsc1wiOnRydWUsXCJWaWV3Q29tcGFuaWVzXCI6dHJ1ZSxcIkVkaXRDb21wYW5pZXNcIjp0cnVlLFwiQWRkQ29tcGFuaWVzXCI6dHJ1ZSxcIkNhbmNlbENvbnRyYWN0XCI6dHJ1ZSxcIkNhbmNlbFdvcmtPcmRlclwiOnRydWUsXCJNb2RpZnlTT1ZBZnRlck9wcG9ydHVuaXR5SXNXb25cIjp0cnVlLFwiQ2hhbmdlQXNzaWduZWRQcm9wZXJ0eUJyYW5jaFwiOnRydWUsXCJNYW5hZ2VVc2VyUm9sZXNcIjp0cnVlLFwiRWRpdEVxdWlwbWVudENvc3RBbmRIb3Vyc1wiOnRydWUsXCJDcmVhdGVFcXVpcG1lbnRJbnNwZWN0aW9uc1wiOnRydWUsXCJSZWNlaXZlUmVjZWlwdFwiOnRydWUsXCJNYW5hZ2VOb3RpZmljYXRpb25zU3lzdGVtXCI6dHJ1ZSxcIk1hbmFnZU5vdGlmaWNhdGlvbnNCcmFuY2hcIjp0cnVlLFwiUmVwb3J0V2ViRGVzaWduZXJcIjp0cnVlLFwiVmlld0ludmVudG9yeUxvY2F0aW9uc1wiOnRydWUsXCJFZGl0SW52ZW50b3J5TG9jYXRpb25zXCI6dHJ1ZSxcIlJvbGVQZXJtaXNzaW9uXCI6W10sXCJMb2NhbEJyYW5jaEFkbWluXCI6ZmFsc2UsXCJIYXNBbnlSZXBvcnRBY2Nlc3NcIjpmYWxzZX0iLCJBc3BpcmVTeXN0ZW1TZXR0aW5ncyI6IntcIkNvbXBhbnlOYW1lXCI6XCJJbmNyZWRpc2NhcGUgVUFUXCIsXCJFc3RpbWF0ZUxpY2Vuc2VcIjp0cnVlLFwiVGlja2V0TWFuYWdlbWVudExpY2Vuc2VcIjp0cnVlLFwiRXN0aW1hdGluZ1N0YWdpbmdcIjpmYWxzZSxcIkludm9pY2luZ0xpY2Vuc2VcIjp0cnVlLFwiQVJNYW5hZ2VtZW50TGljZW5zZVwiOnRydWUsXCJCaWxsaW5nRW1haWxGcm9tQWNjb3VudE93bmVyXCI6ZmFsc2UsXCJQYXljaGV4SW5jbHVkZURhdGVzXCI6dHJ1ZSxcIlJlcXVpcmVVbmlxdWVWZW5kb3JJbnZvaWNlTnVtYmVyXCI6ZmFsc2UsXCJSZXN0cmljdEVkaXRpbmdFbXBsb3llZXNcIjpmYWxzZSxcIkNyZWF0ZVByb3BlcnR5RnJvbUNvbnRhY3RcIjp0cnVlLFwiRW5hYmxlRWxlY3Ryb25pY1NpZ25hdHVyZXNcIjp0cnVlLFwiTWFzdGVyU3lzdGVtXCI6ZmFsc2UsXCJTbm93TW9kZVwiOnRydWUsXCJPcHBvcnR1bml0eUJyYW5jaE92ZXJyaWRlXCI6dHJ1ZSxcIlJvdW5kQ2xvY2tJbk91dFRpbWVzXCI6ZmFsc2UsXCJPTEFQUGl2b3RFbmFibGVkXCI6dHJ1ZSxcIkRpc2FibGVBdXRvbWF0aWNBcHByb3ZhbFwiOnRydWUsXCJEaXNhYmxlTW9iaWxlQ3Jld01hbmFnZW1lbnRcIjpmYWxzZSxcIkRpc2FibGVEZWxldGlvbk9mV29ya1RpY2tldHNcIjpmYWxzZSxcIkFsbG93U3ViVG9Mb2dpblwiOnRydWUsXCJIaWRlU2NoZWR1bGVQcm9ncmVzc0JhclwiOmZhbHNlLFwiV2Fybk9uRWFybHlMdW5jaENsb2NraW5cIjoyLFwiQ2FsaWZvcm5pYVRpbWVQcm9tcHRzXCI6ZmFsc2UsXCJJbnZvaWNpbmdBc3Npc3RhbnRSZXF1aXJlQmlsbGluZ0NvbXBhbnlcIjp0cnVlLFwiRW5mb3JjZUJyYW5jaEFkbWluQWRtaW5pc3RyYXRpb25TZWN1cml0eVwiOnRydWUsXCJPVENhbGN1bGF0aW9uXCI6XCJPdmVycmlkZSBQYXljb2RlXCIsXCJFcXVpcG1lbnRSZWFkaW5nQ2xvY2tPdXRQcm9tcHRcIjpcIkVuZCBvZiBEYXlcIixcIlNob3dOZXRHcm9zc01hcmdpbk9uRXN0aW1hdGluZ1NjcmVlblwiOnRydWUsXCJTaG93T25seUdyb3NzTWFyZ2lub25Fc3RpbWF0aW5nU2NyZWVuXCI6ZmFsc2UsXCJDcmVhdGVFcXVpcG1lbnRSZWFkaW5nc1wiOnRydWUsXCJJbmNsdWRlRHJpdmVUaW1lV2hlbkxvZ2dpbmdFcXVpcG1lbnRDcmV3TW9iaWxlXCI6dHJ1ZSxcIkVuYWJsZU5lZ2F0aXZlQ2hhbmdlT3JkZXJzXCI6dHJ1ZSxcIkVuYWJsZUN1c3RvbWVyUG9ydGFsXCI6dHJ1ZSxcIkRlZmF1bHRHRU9QZXJpbWV0ZXJcIjo1MDAuMCxcIkVuYWJsZUFzcGlyZUdQU0ludGVncmF0aW9uXCI6dHJ1ZSxcIkVuYWJsZUVxdWlwbWVudE1vZHVsZUFkZE9uXCI6dHJ1ZSxcIkdQU0ludGVncmF0aW9uUHJvdmlkZXJcIjozLFwiRW5hYmxlRWxlY3Ryb25pY1BheW1lbnRzXCI6dHJ1ZSxcIkVuYWJsZVNpdGVPbmVcIjpmYWxzZSxcIkJyZWFrVGltZVwiOjAuNSxcIlBheWNoZXhFeHBvcnRGb3JtYXRcIjpcIkRlZmF1bHQgQ1NWXCIsXCJFbmFibGVQYXJ0aWFsVGltZU9uU3ViUG9ydGFsXCI6dHJ1ZSxcIkVuYWJsZVBhcnRpYWxUaW1lT25DcmV3TW9iaWxlXCI6dHJ1ZSxcIkVuYWJsZUxhbmRzY2FwZUh1YkludGVncmF0aW9uXCI6dHJ1ZSxcIkRpc3BsYXlUYXhPbkVzdGltYXRlXCI6dHJ1ZSxcIkxpbmtTY2hlZHVsZW9mVmFsdWV0b1NlcnZpY2VCeURlZmF1bHRcIjpmYWxzZSxcIkVuYWJsZVdlYXRoZXJtYXRpY0ludGVncmF0aW9uXCI6dHJ1ZSxcIkFkdmFuY2VkU2VhcmNoU2VsZWN0VG9wTnVtYmVyXCI6NTAwMCxcIkVuYWJsZU92ZXJVbmRlckFkanVzdG1lbnRzXCI6dHJ1ZSxcIkRlZmF1bHREaXZpc2lvbklERm9yV29ya09yZGVyc1wiOjAsXCJEZWZhdWx0Rm9udFwiOlwiVmVyZGFuYSxzYW5zLXNlcmlmXCIsXCJEZWZhdWx0Rm9udFNpemVcIjpcIjE0LjAwXCIsXCJDcmV3TGVhZGVyUm9sZUlEXCI6MTIwMixcIlJlcXVpcmVOb09wZW5JbnZvaWNlc0NoZWNrXCI6dHJ1ZSxcIlByb2R1Y3RUaWVyXCI6MCxcIkNhbkFjY2Vzc0FQSXNcIjpmYWxzZSxcIkhhc0ZhY2lhbFJlY1wiOmZhbHNlLFwiRW5hYmxlVGFrZW9mZkludGVncmF0aW9uXCI6dHJ1ZSxcIlRha2VvZmZJbnRlZ3JhdGlvblR5cGVcIjo3LFwiRGVmYXVsdFByb3BlcnR5VGFrZW9mZlByb3ZpZGVyXCI6NCxcIkRlZmF1bHRFc3RpbWF0ZVRha2VvZmZQcm92aWRlclwiOjQsXCJFbmFibGVXZWJSZXBvcnREZXNpZ25lclwiOmZhbHNlLFwiQXp1Z2FDdXN0b21lcklEXCI6MTA1OSxcIkVuYWJsZUNyZXdNZW1iZXJDbG9ja0luV2l0aG91dENyZXdMZWFkZXJcIjpmYWxzZSxcIkVuYWJsZUVPTVJlcG9ydFwiOmZhbHNlLFwiVXNlT3Bwb3J0dW5pdHlJdGVtRGlzcGxheU5hbWVPbkludm9pY2VcIjp0cnVlLFwiRW5hYmxlVmlzaXRDaGVja2xpc3RzXCI6dHJ1ZSxcIlRpbWVab25lXCI6XCJBbWVyaWNhL0NoaWNhZ29cIixcIkZpcnN0RGF5T2ZXZWVrXCI6XCJNb25kYXlcIixcIklub3ZhRW5hYmxlZFwiOnRydWUsXCJQVE9WaXNpYmxlXCI6dHJ1ZSxcIk1hcmtldGluZ1Byb0ludGVncmF0aW9uXCI6ZmFsc2UsXCJNYXJrZXRpbmdQcm9WZXJzaW9uXCI6bnVsbCxcIkVuYWJsZUF1dG9UaW1lQWNjZXB0YW5jZUNvbmZpZ1wiOmZhbHNlLFwiRW5hYmxlQXV0b1RpbWVBY2NlcHRhbmNlXCI6ZmFsc2UsXCJFbnRlcnByaXNlQWRtaW5UeXBlXCI6MH0iLCJGb3JiaWRkZW4iOiIiLCJuYmYiOjE3MDU0MjgyNTEsImV4cCI6MTcwNTUxNDY1MSwiaWF0IjoxNzA1NDI4MjUxfQ.Ray35HwIZrMEFZz_MmEAECDy75zr30sOGceKUSyldQw' \
--header 'accept: application/json;odata.metadata=minimal;odata.streaming=true, application/json;odata.metadata=minimal;odata.streaming=false, application/json;odata.metadata=minimal, application/json;odata.metadata=full;odata.streaming=true, application/json;odata.metadata=full;odata.streaming=false, application/json;odata.metadata=full, application/json;odata.metadata=none;odata.streaming=true, application/json;odata.metadata=none;odata.streaming=false, application/json;odata.metadata=none, application/json;odata.streaming=true, application/json;odata.streaming=false, application/json, application/xml, application/prs.odatatestxx-odata, text/plain, text/json'
$skip
$skip is commonly used with $top for pagination. It is used to skip a specific number of records not at the top of the list.
- Integers only.
- Both $top and $skip are used in conjunction.
Example | |
Desired outcome | Skip the first 4,497 contact records. |
Base URL | https://cloud-api.youraspire.com |
Resource | Contacts |
Query Parameter | $skip |
Filter option | 4497 |
Query | https://cloud-api.youraspire.com?$skip=4497 |
Example Response
[
{
"ContactID": 63703,
"CompanyID": 18958,
"CompanyName": "Red Residential",
"ContactTypeID": 2109,
"ContactTypeName": "Prospect",
"OfficeAddress": null,
"HomeAddress": null,
"BranchID": null,
"BranchName": null,
"OwnerContactID": null,
"OwnerContactName": null,
"Salutation": "",
"FirstName": "Laura",
"LastName": "S",
"ProspectRating": null,
"ProspectRatingName": null,
"Title": "Regional Property Manager",
"Email": "",
"MobilePhone": "",
"OfficePhone": "",
"HomePhone": "",
"Fax": "",
"Notes": null,
"Active": true,
"CreatedDateTime": "2023-09-01T13:49:04.343Z",
"CreatedByUserID": 3317,
"CreatedByUserName": "Jo",
"EmployeeNumber": null,
"Website": null,
"EmployeePin": null,
"AccountingSyncID": null,
"ExternalContactReference": null,
"TerminationDate": null,
"HRNotes": null,
"DefaultWorkersCompID": null,
"DefaultWorkersCompName": null,
"DefaultWorkersCompStateProvinceCode": null,
"UserID": null,
"CrewSize": null,
"PromptForCrewSize": null,
"SubCrewLeaderContactID": null,
"PayScheduleID": null,
"ModifiedDate": null,
"ContactTags": []
},
{
"ContactID": 63704,
"CompanyID": 18944,
"CompanyName": "Unified School District",
"ContactTypeID": 2109,
"ContactTypeName": "Prospect",
"OfficeAddress": null,
"HomeAddress": null,
"BranchID": null,
"BranchName": null,
"OwnerContactID": null,
"OwnerContactName": null,
"Salutation": "",
"FirstName": "K",
"LastName": "Ok",
"ProspectRating": null,
"ProspectRatingName": null,
"Title": "Executive Director of Facilities and Construction",
"Email": null,
"MobilePhone": null,
"OfficePhone": null,
"HomePhone": "",
"Fax": "",
"Notes": null,
"Active": true,
"CreatedDateTime": "2023-09-01T13:49:04.39Z",
"CreatedByUserID": 3317,
"CreatedByUserName": "Jos",
"EmployeeNumber": null,
"Website": null,
"EmployeePin": null,
"AccountingSyncID": null,
"ExternalContactReference": null,
"TerminationDate": null,
"HRNotes": null,
"DefaultWorkersCompID": null,
"DefaultWorkersCompName": null,
"DefaultWorkersCompStateProvinceCode": null,
"UserID": null,
"CrewSize": null,
"PromptForCrewSize": null,
"SubCrewLeaderContactID": null,
"PayScheduleID": null,
"ModifiedDate": null,
"ContactTags": []
},
Code Sample
curl --request GET \
--url 'https://cloud.api.youraspire.com/Contacts?%24skip=4497&%24top=3' \
--header 'Authorization: eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJBc3BpcmVTeXN0ZW1JRCI6IjE1IiwiVXNlcklEIjoiNDg0OCIsIlVzZXJQZXJtaXNzaW9ucyI6IntcIlJvbGVJRFwiOjAsXCJSb2xlTmFtZVwiOm51bGwsXCJSZXF1aXJlZFwiOmZhbHNlLFwiUm9sZVZhbHVlXCI6MSxcIkFkZENvbnRhY3RcIjp0cnVlLFwiRWRpdE15Q29udGFjdHNcIjp0cnVlLFwiRWRpdEFsbENvbnRhY3RzXCI6dHJ1ZSxcIkRlbGV0ZUNvbnRhY3RcIjpmYWxzZSxcIkFkZEVtcGxveWVlSW5jaWRlbnRcIjp0cnVlLFwiRWRpdEFjY291bnRpbmdTeW5jSURcIjp0cnVlLFwiQnVsa0VtYWlsQ29udGFjdHNcIjp0cnVlLFwiU2VuZEN1c3RvbWVyUG9ydGFsSW52aXRhdGlvblwiOnRydWUsXCJJbXBvcnRDb250YWN0QW5kUHJvcGVydHlcIjp0cnVlLFwiQ29uZmlndXJlQ29udGFjdFJlcXVpcmVkRmllbGRzXCI6dHJ1ZSxcIkRlbGV0ZU1lcmdlQ29udGFjdHNcIjp0cnVlLFwiVXBkYXRlRW1wbG95ZWVQSU5cIjpmYWxzZSxcIkFkZFByb3BlcnR5XCI6dHJ1ZSxcIkVkaXRNeVByb3BlcnRpZXNcIjp0cnVlLFwiRWRpdEFsbFByb3BlcnRpZXNcIjp0cnVlLFwiRGVsZXRlUHJvcGVydHlcIjpmYWxzZSxcIkVkaXRRdWFsaXR5QXVkaXRzXCI6dHJ1ZSxcIlZpZXdQcm9wZXJ0aWVzXCI6dHJ1ZSxcIlZpZXdNeVByb3BlcnRpZXNcIjpmYWxzZSxcIkFkZE9wcG9ydHVuaXR5XCI6dHJ1ZSxcIkVkaXRNeU9wcG9ydHVuaXRpZXNcIjp0cnVlLFwiRWRpdEFsbE9wcG9ydHVuaXRpZXNcIjp0cnVlLFwiRGVsZXRlT3Bwb3J0dW5pdHlcIjp0cnVlLFwiQ2hhbmdlT3Bwb3J0dW5pdHlcIjp0cnVlLFwiVmlld1JlYWRPbmx5RXN0aW1hdGVzXCI6dHJ1ZSxcIlVuY2FuY2VsT3Bwb3J0dW5pdHlcIjp0cnVlLFwiSm9iRGFzaGJvYXJkXCI6dHJ1ZSxcIkltcG9ydEVzdGltYXRlXCI6dHJ1ZSxcIkVkaXRTZXJ2aWNlUGF5Q29kZXNcIjp0cnVlLFwiRGVsZXRlQWN0aXZpdHlcIjp0cnVlLFwiU3lzdGVtQWRtaW5cIjp0cnVlLFwiQnJhbmNoQWRtaW5cIjpmYWxzZSxcIlZpZXdSb3V0ZXNcIjp0cnVlLFwiTWFuYWdlT3Bwb3J0dW5pdHlUZW1wbGF0ZXNcIjp0cnVlLFwiTWFuYWdlR2VuZXJhbENvbmRpdGlvblRlbXBsYXRlc1wiOnRydWUsXCJNYWtlVmlzaXRDaGVja2xpc3RJdGVtc01hbmRhdG9yeVwiOnRydWUsXCJFZGl0RGFpbHlQbGFuUmVwb3J0XCI6dHJ1ZSxcIk1hcmtldGluZ1Byb1wiOnRydWUsXCJFeHBvcnRHcmlkc1wiOnRydWUsXCJFZGl0VGVtcGxhdGVzXCI6dHJ1ZSxcIk1hbmFnZVRlbXBsYXRlc1wiOnRydWUsXCJFZGl0RXN0aW1hdGVQcmljaW5nUGN0XCI6dHJ1ZSxcIkVkaXRFc3RpbWF0ZUl0ZW1zXCI6dHJ1ZSxcIkhvdXJSZWR1Y3Rpb25QY3RcIjoxMDAuMCxcIlByaWNlUmVkdWN0aW9uUGN0XCI6MTAwLjAsXCJVbmJhbGFuY2VkUGF5bWVudFNjaGVkdWxlXCI6dHJ1ZSxcIkFsbG93T25lVGltZUl0ZW1zXCI6dHJ1ZSxcIkFkZEl0ZW1zVG9DYXRhbG9nXCI6dHJ1ZSxcIkNoYW5nZVNlcnZpY2VJbnZvaWNlVHlwZU9uRml4ZWRQcmljZU9wZW5CaWxsaW5nXCI6dHJ1ZSxcIkFkanVzdEdlbmVyYWxDb25kaXRpb25zXCI6dHJ1ZSxcIkFkZE1vZGlmeVBheWNvZGVPdmVycmlkZXNcIjp0cnVlLFwiQXNOZWVkZWRFeGNlcHRpb25SZXBvcnRcIjp0cnVlLFwiTWFrZU9wcG9ydHVuaXR5U2VydmljZVZpc2l0Q2hlY2tsaXN0SXRlbXNNYW5kYXRvcnlcIjp0cnVlLFwiUHJvZHVjdGlvblwiOmZhbHNlLFwiVXBkYXRlSm9iXCI6ZmFsc2UsXCJDYW5jZWxXb3JrVGlja2V0XCI6dHJ1ZSxcIlNjaGVkdWxlQm9hcmRcIjp0cnVlLFwiU2NoZWR1bGVCb2FyZFJlYWRPbmx5XCI6dHJ1ZSxcIlJvdXRlT3B0aW1pemF0aW9uXCI6dHJ1ZSxcIlNjaGVkdWxlQW5FdmVudFwiOnRydWUsXCJBY2Nlc3NBdXRvVGltZUFjY2VwdGFuY2VSZXBvcnRzXCI6ZmFsc2UsXCJFZGl0Um91dGVzXCI6dHJ1ZSxcIkNyZXdMZWFkZXJcIjp0cnVlLFwiRXN0aW1hdGVcIjpmYWxzZSxcIlZpZXdBbGxUaW1lXCI6dHJ1ZSxcIk15UmVwb3J0c1wiOnRydWUsXCJBZHZhbmNlZFNlYXJjaFN5c3RlbUFkbWluXCI6ZmFsc2UsXCJIUkFkbWluXCI6dHJ1ZSxcIlNhbGVzTWFuYWdlclwiOnRydWUsXCJFZGl0UHJvcGVydHlCaWxsaW5nQ29udGFjdFwiOnRydWUsXCJVbmFwcHJvdmVSZWNlaXB0XCI6dHJ1ZSxcIkFwcHJvdmVUaW1lXCI6dHJ1ZSxcIkV4cG9ydFRpbWVcIjp0cnVlLFwiRWRpdFByaWNpbmdcIjp0cnVlLFwiQ2hvb3NlUmVwb3J0RXhwb3J0VHlwZVwiOnRydWUsXCJFZGl0QnVkZ2V0XCI6dHJ1ZSxcIlVuYXBwcm92ZVRpbWVcIjp0cnVlLFwiVmlld1JlYWRPbmx5UGF5cm9sbERhdGFcIjp0cnVlLFwiSW5vdmFMYWJvckJ1cmRlblRydWVVcFwiOnRydWUsXCJDcmVhdGVPdmVyVW5kZXJBZGp1c3RtZW50UmVjb3Jkc1wiOnRydWUsXCJDcmVhdGVSZWNlaXB0XCI6dHJ1ZSxcIkFwcHJvdmVSZWNlaXB0XCI6dHJ1ZSxcIkRlbGV0ZVJlY2VpcHRcIjp0cnVlLFwiQWRkUHVyY2hhc2VDcmVkaXRcIjp0cnVlLFwiU3VibWl0UmVjZWlwdFRvTGFuZHNjYXBlSHViXCI6dHJ1ZSxcIkFsbG93RXN0aW1hdGVOZWdhdGl2ZVF1YW50aXR5XCI6dHJ1ZSxcIkNyZWF0ZUludm9pY2VcIjp0cnVlLFwiVmlld0ludm9pY2luZ1wiOnRydWUsXCJFZGl0SW52b2ljaW5nXCI6dHJ1ZSxcIkRlbGV0ZUludm9pY2luZ1wiOnRydWUsXCJDcmVhdGVNaXNjSW52b2ljZVwiOmZhbHNlLFwiVmlld0FSTWFuYWdlbWVudFwiOnRydWUsXCJFZGl0QmlsbGluZ1wiOnRydWUsXCJWaWV3UHVyY2hhc2luZ1wiOnRydWUsXCJWaWV3UmV2ZW51ZVwiOnRydWUsXCJWaWV3UmVwb3J0c1wiOnRydWUsXCJDb21wbGV0ZVdvcmtUaWNrZXRcIjp0cnVlLFwiQXBwcm92ZVdvcmtUaWNrZXRcIjp0cnVlLFwiRGVsZXRlV29ya1RpY2tldFwiOnRydWUsXCJTd2FwQXNOZWVkZWRTZXJ2aWNlc1wiOnRydWUsXCJQYXJ0aWFsT2NjdXJcIjp0cnVlLFwiTW92ZVdvcmtUaWNrZXRDb3N0c1wiOnRydWUsXCJWaWV3T3Bwb3J0dW5pdGllc1wiOnRydWUsXCJWaWV3TXlPcHBvcnR1bml0aWVzXCI6ZmFsc2UsXCJXaW5Db250cmFjdFwiOnRydWUsXCJXaW5Xb3JrT3JkZXJcIjp0cnVlLFwiTG9zZU9wcG9ydHVuaXRpZXNcIjp0cnVlLFwiQWRkQ3JlZGl0TWVtb1wiOnRydWUsXCJUaWNrZXRCdWxrRW1haWxcIjp0cnVlLFwiRWRpdEJ1ZGdldGVkSG91ckFuZFJldmVudWVcIjp0cnVlLFwiUmVwb3J0QWNjZXNzXCI6e30sXCJNb2RpZnlTZW50SW52b2ljZXNcIjp0cnVlLFwiQWRkQ3Jld0xlYWRlckNvbnRhY3RcIjp0cnVlLFwiT3ZlcnJpZGVUb3RhbENvc3RcIjp0cnVlLFwiRWRpdEVhcm5lZFJldmVudWVcIjp0cnVlLFwiVmlld0tQSU92ZXJoZWFkUmVjb3ZlcnlcIjp0cnVlLFwiVmlld0tQSUNsaWVudE1hbmFnZW1lbnRcIjp0cnVlLFwiVmlld0tQSVByb2ZpdExvc3NcIjp0cnVlLFwiVmlld0tQSUZvcmVjYXN0XCI6dHJ1ZSxcIlZpZXdLUElDb21wbGV0ZWRMYWJvckVmZmljaWVuY3lcIjp0cnVlLFwiVmlld0tQSVNhbGVzU2NvcmVDYXJkXCI6dHJ1ZSxcIlZpZXdTYWxlc1BpcGVsaW5lSW5zaWdodFwiOnRydWUsXCJWaWV3Q3VzdG9tZXJJc3N1ZXNJbnNpZ2h0XCI6dHJ1ZSxcIkNsb3NlTW9udGhcIjp0cnVlLFwiQXBwcm92ZUVxdWlwbWVudFwiOnRydWUsXCJEaXNwb3NlRXF1aXBtZW50XCI6dHJ1ZSxcIkRlbGV0ZUVxdWlwbWVudFwiOnRydWUsXCJFcXVpcG1lbnRBZG1pblwiOnRydWUsXCJNYXJrRXF1aXBtZW50SW5TZXJ2aWNlXCI6dHJ1ZSxcIk1hcmtFcXVpcG1lbnRPdXRPZlNlcnZpY2VcIjp0cnVlLFwiUHVyY2hhc2VFcXVpcG1lbnRcIjp0cnVlLFwiUmVxdWVzdEVxdWlwbWVudFwiOnRydWUsXCJWaWV3RXF1aXBtZW50XCI6dHJ1ZSxcIkVzdGltYXRlQ3VzdG9tQ29sdW1uXCI6dHJ1ZSxcIlRyaWdnZXJBdXRvRXhwZW5zZUNyZWF0aW9uXCI6dHJ1ZSxcIlJvdXRlU2NoZWR1bGluZ1wiOnRydWUsXCJBZGRGdWVsUmF0ZVwiOnRydWUsXCJGdWVsQ29zdFJlcG9ydFwiOnRydWUsXCJNYW5hZ2VDdXN0b21GaWVsZHNcIjp0cnVlLFwiUHJvY2Vzc0VsZWN0cm9uaWNQYXltZW50c1wiOnRydWUsXCJWb2lkRWxlY3Ryb25pY1BheW1lbnRzXCI6dHJ1ZSxcIlJlZnVuZEVsZWN0cm9uaWNQYXltZW50c1wiOnRydWUsXCJFeHBpcmluZ0VsZWN0cm9uaWNQYXltZW50TWV0aG9kc0FsZXJ0c1wiOnRydWUsXCJSZWplY3RlZEVsZWN0cm9uaWNQYXltZW50c0FsZXJ0c1wiOnRydWUsXCJBbm51YWxSZW5ld2Fsc1wiOnRydWUsXCJWaWV3Q29tcGFuaWVzXCI6dHJ1ZSxcIkVkaXRDb21wYW5pZXNcIjp0cnVlLFwiQWRkQ29tcGFuaWVzXCI6dHJ1ZSxcIkNhbmNlbENvbnRyYWN0XCI6dHJ1ZSxcIkNhbmNlbFdvcmtPcmRlclwiOnRydWUsXCJNb2RpZnlTT1ZBZnRlck9wcG9ydHVuaXR5SXNXb25cIjp0cnVlLFwiQ2hhbmdlQXNzaWduZWRQcm9wZXJ0eUJyYW5jaFwiOnRydWUsXCJNYW5hZ2VVc2VyUm9sZXNcIjp0cnVlLFwiRWRpdEVxdWlwbWVudENvc3RBbmRIb3Vyc1wiOnRydWUsXCJDcmVhdGVFcXVpcG1lbnRJbnNwZWN0aW9uc1wiOnRydWUsXCJSZWNlaXZlUmVjZWlwdFwiOnRydWUsXCJNYW5hZ2VOb3RpZmljYXRpb25zU3lzdGVtXCI6dHJ1ZSxcIk1hbmFnZU5vdGlmaWNhdGlvbnNCcmFuY2hcIjp0cnVlLFwiUmVwb3J0V2ViRGVzaWduZXJcIjp0cnVlLFwiVmlld0ludmVudG9yeUxvY2F0aW9uc1wiOnRydWUsXCJFZGl0SW52ZW50b3J5TG9jYXRpb25zXCI6dHJ1ZSxcIlJvbGVQZXJtaXNzaW9uXCI6W10sXCJMb2NhbEJyYW5jaEFkbWluXCI6ZmFsc2UsXCJIYXNBbnlSZXBvcnRBY2Nlc3NcIjpmYWxzZX0iLCJBc3BpcmVTeXN0ZW1TZXR0aW5ncyI6IntcIkNvbXBhbnlOYW1lXCI6XCJJbmNyZWRpc2NhcGUgVUFUXCIsXCJFc3RpbWF0ZUxpY2Vuc2VcIjp0cnVlLFwiVGlja2V0TWFuYWdlbWVudExpY2Vuc2VcIjp0cnVlLFwiRXN0aW1hdGluZ1N0YWdpbmdcIjpmYWxzZSxcIkludm9pY2luZ0xpY2Vuc2VcIjp0cnVlLFwiQVJNYW5hZ2VtZW50TGljZW5zZVwiOnRydWUsXCJCaWxsaW5nRW1haWxGcm9tQWNjb3VudE93bmVyXCI6ZmFsc2UsXCJQYXljaGV4SW5jbHVkZURhdGVzXCI6dHJ1ZSxcIlJlcXVpcmVVbmlxdWVWZW5kb3JJbnZvaWNlTnVtYmVyXCI6ZmFsc2UsXCJSZXN0cmljdEVkaXRpbmdFbXBsb3llZXNcIjpmYWxzZSxcIkNyZWF0ZVByb3BlcnR5RnJvbUNvbnRhY3RcIjp0cnVlLFwiRW5hYmxlRWxlY3Ryb25pY1NpZ25hdHVyZXNcIjp0cnVlLFwiTWFzdGVyU3lzdGVtXCI6ZmFsc2UsXCJTbm93TW9kZVwiOnRydWUsXCJPcHBvcnR1bml0eUJyYW5jaE92ZXJyaWRlXCI6dHJ1ZSxcIlJvdW5kQ2xvY2tJbk91dFRpbWVzXCI6ZmFsc2UsXCJPTEFQUGl2b3RFbmFibGVkXCI6dHJ1ZSxcIkRpc2FibGVBdXRvbWF0aWNBcHByb3ZhbFwiOnRydWUsXCJEaXNhYmxlTW9iaWxlQ3Jld01hbmFnZW1lbnRcIjpmYWxzZSxcIkRpc2FibGVEZWxldGlvbk9mV29ya1RpY2tldHNcIjpmYWxzZSxcIkFsbG93U3ViVG9Mb2dpblwiOnRydWUsXCJIaWRlU2NoZWR1bGVQcm9ncmVzc0JhclwiOmZhbHNlLFwiV2Fybk9uRWFybHlMdW5jaENsb2NraW5cIjoyLFwiQ2FsaWZvcm5pYVRpbWVQcm9tcHRzXCI6ZmFsc2UsXCJJbnZvaWNpbmdBc3Npc3RhbnRSZXF1aXJlQmlsbGluZ0NvbXBhbnlcIjp0cnVlLFwiRW5mb3JjZUJyYW5jaEFkbWluQWRtaW5pc3RyYXRpb25TZWN1cml0eVwiOnRydWUsXCJPVENhbGN1bGF0aW9uXCI6XCJPdmVycmlkZSBQYXljb2RlXCIsXCJFcXVpcG1lbnRSZWFkaW5nQ2xvY2tPdXRQcm9tcHRcIjpcIkVuZCBvZiBEYXlcIixcIlNob3dOZXRHcm9zc01hcmdpbk9uRXN0aW1hdGluZ1NjcmVlblwiOnRydWUsXCJTaG93T25seUdyb3NzTWFyZ2lub25Fc3RpbWF0aW5nU2NyZWVuXCI6ZmFsc2UsXCJDcmVhdGVFcXVpcG1lbnRSZWFkaW5nc1wiOnRydWUsXCJJbmNsdWRlRHJpdmVUaW1lV2hlbkxvZ2dpbmdFcXVpcG1lbnRDcmV3TW9iaWxlXCI6dHJ1ZSxcIkVuYWJsZU5lZ2F0aXZlQ2hhbmdlT3JkZXJzXCI6dHJ1ZSxcIkVuYWJsZUN1c3RvbWVyUG9ydGFsXCI6dHJ1ZSxcIkRlZmF1bHRHRU9QZXJpbWV0ZXJcIjo1MDAuMCxcIkVuYWJsZUFzcGlyZUdQU0ludGVncmF0aW9uXCI6dHJ1ZSxcIkVuYWJsZUVxdWlwbWVudE1vZHVsZUFkZE9uXCI6dHJ1ZSxcIkdQU0ludGVncmF0aW9uUHJvdmlkZXJcIjozLFwiRW5hYmxlRWxlY3Ryb25pY1BheW1lbnRzXCI6dHJ1ZSxcIkVuYWJsZVNpdGVPbmVcIjpmYWxzZSxcIkJyZWFrVGltZVwiOjAuNSxcIlBheWNoZXhFeHBvcnRGb3JtYXRcIjpcIkRlZmF1bHQgQ1NWXCIsXCJFbmFibGVQYXJ0aWFsVGltZU9uU3ViUG9ydGFsXCI6dHJ1ZSxcIkVuYWJsZVBhcnRpYWxUaW1lT25DcmV3TW9iaWxlXCI6dHJ1ZSxcIkVuYWJsZUxhbmRzY2FwZUh1YkludGVncmF0aW9uXCI6dHJ1ZSxcIkRpc3BsYXlUYXhPbkVzdGltYXRlXCI6dHJ1ZSxcIkxpbmtTY2hlZHVsZW9mVmFsdWV0b1NlcnZpY2VCeURlZmF1bHRcIjpmYWxzZSxcIkVuYWJsZVdlYXRoZXJtYXRpY0ludGVncmF0aW9uXCI6dHJ1ZSxcIkFkdmFuY2VkU2VhcmNoU2VsZWN0VG9wTnVtYmVyXCI6NTAwMCxcIkVuYWJsZU92ZXJVbmRlckFkanVzdG1lbnRzXCI6dHJ1ZSxcIkRlZmF1bHREaXZpc2lvbklERm9yV29ya09yZGVyc1wiOjAsXCJEZWZhdWx0Rm9udFwiOlwiVmVyZGFuYSxzYW5zLXNlcmlmXCIsXCJEZWZhdWx0Rm9udFNpemVcIjpcIjE0LjAwXCIsXCJDcmV3TGVhZGVyUm9sZUlEXCI6MTIwMixcIlJlcXVpcmVOb09wZW5JbnZvaWNlc0NoZWNrXCI6dHJ1ZSxcIlByb2R1Y3RUaWVyXCI6MCxcIkNhbkFjY2Vzc0FQSXNcIjpmYWxzZSxcIkhhc0ZhY2lhbFJlY1wiOmZhbHNlLFwiRW5hYmxlVGFrZW9mZkludGVncmF0aW9uXCI6dHJ1ZSxcIlRha2VvZmZJbnRlZ3JhdGlvblR5cGVcIjo3LFwiRGVmYXVsdFByb3BlcnR5VGFrZW9mZlByb3ZpZGVyXCI6NCxcIkRlZmF1bHRFc3RpbWF0ZVRha2VvZmZQcm92aWRlclwiOjQsXCJFbmFibGVXZWJSZXBvcnREZXNpZ25lclwiOmZhbHNlLFwiQXp1Z2FDdXN0b21lcklEXCI6MTA1OSxcIkVuYWJsZUNyZXdNZW1iZXJDbG9ja0luV2l0aG91dENyZXdMZWFkZXJcIjpmYWxzZSxcIkVuYWJsZUVPTVJlcG9ydFwiOmZhbHNlLFwiVXNlT3Bwb3J0dW5pdHlJdGVtRGlzcGxheU5hbWVPbkludm9pY2VcIjp0cnVlLFwiRW5hYmxlVmlzaXRDaGVja2xpc3RzXCI6dHJ1ZSxcIlRpbWVab25lXCI6XCJBbWVyaWNhL0NoaWNhZ29cIixcIkZpcnN0RGF5T2ZXZWVrXCI6XCJNb25kYXlcIixcIklub3ZhRW5hYmxlZFwiOnRydWUsXCJQVE9WaXNpYmxlXCI6dHJ1ZSxcIk1hcmtldGluZ1Byb0ludGVncmF0aW9uXCI6ZmFsc2UsXCJNYXJrZXRpbmdQcm9WZXJzaW9uXCI6bnVsbCxcIkVuYWJsZUF1dG9UaW1lQWNjZXB0YW5jZUNvbmZpZ1wiOmZhbHNlLFwiRW5hYmxlQXV0b1RpbWVBY2NlcHRhbmNlXCI6ZmFsc2UsXCJFbnRlcnByaXNlQWRtaW5UeXBlXCI6MH0iLCJGb3JiaWRkZW4iOiIiLCJuYmYiOjE3MDU0MjgyNTEsImV4cCI6MTcwNTUxNDY1MSwiaWF0IjoxNzA1NDI4MjUxfQ.Ray35HwIZrMEFZz_MmEAECDy75zr30sOGceKUSyldQw' \
--header 'accept: application/json;odata.metadata=minimal;odata.streaming=true, application/json;odata.metadata=minimal;odata.streaming=false, application/json;odata.metadata=minimal, application/json;odata.metadata=full;odata.streaming=true, application/json;odata.metadata=full;odata.streaming=false, application/json;odata.metadata=full, application/json;odata.metadata=none;odata.streaming=true, application/json;odata.metadata=none;odata.streaming=false, application/json;odata.metadata=none, application/json;odata.streaming=true, application/json;odata.streaming=false, application/json, application/xml, application/prs.odatatestxx-odata, text/plain, text/json'
$pageNumber
This parameter is not an Odata query option. It is a customized pagination function that allows you to designate the results page number that should be returned. It can be used independently or with the $limit query option.
- Integers only.
- Both $pageNumber and $limit are used in conjunction.
Example | |
Desired outcome | Only return contact records on the first page. (By default, there are 1000 records per page) |
Base URL | https://cloud-api.youraspire.com |
Resource | Contacts |
Query Parameter | $pagenumber |
Option(s) | 1 |
Query | https://cloud-api.youraspire.com?$pagenumber=1 |
$limit
This query option must be used with $pageNumbe to limit the number of items returned on a page.
- Integers only.
- Use both $pageNumber and $limit are used in conjunction. $limit should follow $pageNumber .
Example | |
Desired outcome | Only return the first 20 contact records on the first page. |
Base URL | https://cloud-api.youraspire.com |
Resource | Contacts |
Query Parameter (s) | $pageNumber $limit |
Option(s) | $pageNumber 1 $limit 20 |
Query | https://cloud-api.youraspire.com?$pagenumber=1&limit=20 |
Using multiple query options
All query options can be combined. To do so successfully, abide by the syntax rules and don't duplicate query options in the same request.
Example | |
Desired outcome | Only return 20 catalog items with an item type of Material or Equipment on the first page sorted by item cost in descending order. The item cost should be greater than 50. |
Base URL | https://cloud-api.youraspire.com |
Resource | CatalogItems |
Query Parameter(s) | $filter $orderby $limit $pageNumber |
Option(s) | $filter ItemType in ('Material','Equipment') and ItemCost gt 50 $orderby ItemCostdesc $limit 20 $pagenumber 1 |
Query | https://cloud-api.youraspire.com?$filter=ItemType in ('Material','Equipment') and ItemCost gt 50 &$orderby=ItemCostdesc&$limit=20&$pageNumber=1 |
Nested Collections
A nested collection is a method of organizing and structuring information that is easier to interact with, as it requires fewer requests when the request is properly created. It refers to a group of entities (fields and or properties) embedded within another with which it is associated. Within a nested collection, a hierarchical relationship is formed between entities - there is a parent attribute that can be used independently in a one-to-one relationship that owns a nested collection beneath it.
The nested collection belonging to the parent entity can also have its nested collections. Each set of nested collections is typically categorized as a level, characterized by its relative closeness to the parent entity. Nested endpoints are usually queried with the $expand option in combination with the $filter and $select query options.
$expand
The $expand query option is particularly helpful when used with endpoints with a one-to-many relationship defined throughout their properties because it allows you to retrieve information nested within a property from one request. When using the $expand query option, the following criteria must be met:
- A $select, $filter, or another $expand query option must also be used.
- All fields will be returned if the $select field is not used.
Example | |
Desired Outcome | Return all fields of receipts and underlying receipt items for Hardwood Mulch. |
Base URL | https://cloud-api.youraspire.com |
Resource | Receipts |
Query Parameter(s) | $expand $filter |
Options(s) | $expand ReceiptItems $filter in (CatalogItemName eq 'Hardwood Mulch') |
Query | https://cloud-api.youraspire.com?$expand=ReceiptItems($filter=CatalogItemName eq'Hardwood Mulch') |
Good practice
- Avoid using $orderby and $top query parameters for large data sets.
- Filtering integers instead of string fields is optimal.