A standards profile is a set of eBay seller metrics and the seller's associated compliance values (either
A seller's multiple profiles are distinguished by two criteria, a "program" and a "cycle." A profile's program is one of three regions where the seller may have done business, or
PROGRAM_GLOBALto indicate all marketplaces where the seller has done business. The cycle value specifies whether the standards compliance values were determined at the last official eBay evaluation or at the time of the request.
Resource URI (production)
HTTP request headers
This request requires an access token created with the authorization code grant flow, using one or more scopes from the following list (please check your Application Keys page for a list of OAuth scopes available to your application):
See OAuth access tokens for more information.
|standardsProfiles||array of StandardsProfile||A list of the seller's standards profiles. |
A "standards profile" is a set of eBay seller standards categories and the values related to the associated seller.
Profiles are distinguished by a combination of cycle and program values. The "program" value specifies the region to which the data is from. The "cycle" value specifies whether the values were determined just now, or if the values are from the last official eBay seller standards evaluation.
|standardsProfiles.cycle||Cycle||A complex type that specifies the profile's evaluation cycle (|
Each program has at least one cycle, but a program can include both cycle types.
|standardsProfiles.cycle.cycleType||CycleTypeEnum||The cycle type, either |
|standardsProfiles.cycle.evaluationDate||string||The date and time at which the standard compliance values were determined for the profile. |
The time stamp is formatted as an ISO 8601 string, which is based on the 24-hour Universal Coordinated Time (UTC) clock.
|standardsProfiles.cycle.evaluationMonth||string||The month in which the currently effective seller level was computed. |
The value is always formatted as
|standardsProfiles.defaultProgram||boolean||If set to |
Except for sellers in China, a seller's default program is the marketplace where they registered with eBay. Seller's in China select their default program when they register.
|standardsProfiles.evaluationReason||string||Specifies how the overall seller level was calculated. |
In the event of special circumstances (as determined by eBay), eBay may override the calculated seller level. In general, such overrides protect a seller's level. The usual value for both cycle types is "Seller level generated by standards monthly evaluation cycle."
|standardsProfiles.metrics||array of Metric||A list of the metrics upon which a seller's profile is evaluated. |
Each program's applicable metrics and requirements are listed at eBay Top Rated seller program standards.
|standardsProfiles.metrics.level||StandardsLevelEnum||The seller level for this metric, which indicates how well the seller is doing in meeting eBay's standards for this metric. Possible values are TOP_RATED, ABOVE_STANDARD, and BELOW_STANDARD. |
|standardsProfiles.metrics.lookbackEndDate||string||The end date and time, in ISO 8601 format, when the seller was evaluated for this metric. |
|standardsProfiles.metrics.lookbackStartDate||string||The start date and time, in ISO 8601 format, when the seller was evaluated for this metric. |
|standardsProfiles.metrics.metricKey||string||An internal key string specifying a metric. These are short, abbreviated, strings such as |
|standardsProfiles.metrics.name||string||A descriptive name for the metric. For example, "Transaction defect rate." This value is localized according to the value of the X-EBAY-C-MARKETPLACE-ID request header. |
|standardsProfiles.metrics.thresholdLowerBound||any||Specifies the lowest number value can be and still qualify for the currently assigned seller level. |
For example, if a seller is assigned the level
The lower bound value is optional. For example, if the seller is below standard for this metric, there is no value they can go below for it to further lower their compliance level. Note that each program can have different metric-threshold levels.
|standardsProfiles.metrics.thresholdMetaData||string||An expression that indicates the inclusive and exclusive characteristics of the upper and lower threshold boundaries. |
A metric's thresholdLowerBound and thresholdUpperBound values specify the boundary values that define the current standard compliance level (
For example, suppose a seller's level is
|standardsProfiles.metrics.thresholdUpperBound||any||Specifies the highest number value can be and still qualify for the currently assigned seller level. |
For example, if a seller is assigned the level
The upper bound value is optional. For example, if the seller is top rated for this metric, there is no value they can go above for it to further raise their compliance level. Note that each program can have different metric-threshold levels.
|standardsProfiles.metrics.type||DataTypeEnum||Indicates the data type of the returned metric. Possible values are: AMOUNT, BOOLEAN, DATE, FRACTION, NUMBER, and STRING. |
|standardsProfiles.metrics.value||any||The seller's calculated value, or score, for the metric. |
|standardsProfiles.program||ProgramEnum||Indicates the program used to generate the profile data. Values can be |
|standardsProfiles.standardsLevel||StandardsLevelEnum||The overall standards level of the seller, one of |
New to making API calls? Please see Making a Call.
Note: Identifiers, such as order IDs or user IDs, and personal data in these samples might be anonymized or may no longer be active on eBay. If necessary, substitute current, relevant eBay data in your requests.