eBay · Schema

UserScheduleCollection

The type that defines the fields for a paginated result set of user schedules. The response consists of 0 or more sequenced pages where each page has 0 or more items.

AuctionsCommerceProductsMarketplaceFortune 500

Properties

Name Type Description
href string The path to the call URI that produced the current page of results.
limit integer The value of the limit parameter submitted in the request, which is the maximum number of schedules to return per page, from the result set. A result set is the complete set of schedu
next string The path to the call URI for the next page of results. This value is returned if there is an additional page of results to return from the result set.
offset integer The number of results skipped in the result set before listing the first returned result. This value can be set in the request with the offset query parameter.

Note

prev string The path to the call URI for the previous page of results. This is returned if there is a previous page of results from the result set.
schedules array An array of the schedules on this page. An empty array is returned if the filter criteria excludes all tasks.
total integer The total number of schedules that match the input criteria.
View JSON Schema on GitHub

JSON Schema

ebay-userschedulecollection-schema.json Raw ↑
{
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "$id": "#/components/schemas/UserScheduleCollection",
  "title": "UserScheduleCollection",
  "type": "object",
  "properties": {
    "href": {
      "type": "string",
      "description": "The path to the call URI that produced the current page of results."
    },
    "limit": {
      "type": "integer",
      "description": "The value of the <strong>limit</strong> parameter submitted in the request, which is the maximum number of schedules to return per page, from the result set. A result set is the complete set of schedules returned by the method. <p> <span class=\"tablenote\"><strong>Note:</strong> Though this parameter is not required to be submitted in the request, the parameter defaults to 10 if omitted.<p> <span class=\"tablenote\"><strong>Note:</strong> If this is the last or only page of the result set, the page may contain fewer tasks than the <strong>limit</strong> value. To determine the number of pages in a result set, divide the total value (total number of tasks matching input criteria) by this limit value, and then round up to the next integer. For example, if the <strong>total</strong> value was <code>120</code> (120 total tasks) and the <strong>limit</strong> value was <code>50</code> (show 50 tasks per page), the total number of pages in the result set is three, so the seller would have to make three separate <strong>getSchedules</strong> calls to view all tasks matching the input criteria.</span></p></span></p>",
      "format": "int32"
    },
    "next": {
      "type": "string",
      "description": "The path to the call URI for the next page of results. This value is returned if there is an additional page of results to return from the result set."
    },
    "offset": {
      "type": "integer",
      "description": "The number of results skipped in the result set before listing the first returned result. This value can be set in the request with the <b>offset</b> query parameter. <p class=\"tablenote\"><strong>Note: </strong>The items in a paginated result set use a zero-based list where the first item in the list has an offset of <code>0</code>.</p>",
      "format": "int32"
    },
    "prev": {
      "type": "string",
      "description": "The path to the call URI for the previous page of results. This is returned if there is a previous page of results from the result set."
    },
    "schedules": {
      "type": "array",
      "description": "An array of the schedules on this page. An empty array is returned if the filter criteria excludes all tasks.",
      "items": {
        "$ref": "#/components/schemas/UserScheduleResponse"
      }
    },
    "total": {
      "type": "integer",
      "description": "The total number of schedules that match the input criteria.",
      "format": "int32"
    }
  },
  "description": "The type that defines the fields for a paginated result set of user schedules. The response consists of 0 or more sequenced <em> pages</em> where each page has 0 or more items."
}