---
title: VeRO API
description: "The eBay **VeRO API** allows owners of an intellectual property, such as a copyright or trademark, to report eBay listings that infringe on their intellectual property rights. **Important!** The VeRO API is only available to members of the Verified Rights Owner (VeRO) Program."
api_version: 1.0
api_name: vero_public_apis
api_type: REST
api_group: sell/vero_public_apis
source_url:
  html: https://developer.ebay.com/develop/api/sell/vero_public_apis
  md: https://developer.ebay.com/develop/api/sell/vero_public_apis.md
---

# VeRO API API

The eBay **VeRO API** allows owners of an intellectual property, such as a copyright or trademark, to report eBay listings that infringe on their intellectual property rights.

**Important!** The VeRO API is only available to members of the Verified Rights Owner (VeRO) Program.

## API Methods

The following API methods are available:

### getVeroReasonCode

#### GET /vero_reason_code/{vero_reason_code_id}
**Description:** **Important!** You must be a member of the Verified Rights Owner (VeRO) Program to use this call.

  
This method is used to retrieve the details of a specific VeRO reason code, including a description of the code and the marketplace associated with the code.  
  
The **vero\_reason\_code\_id** of the VeRO reason code for which to retrieve details is required as a path parameter.
**Parameters:**
- **vero_reason_code_id** (string) *required*
  - This path parameter specifies the unique identifier of the VeRO reason code that is to be retrieved.  
  
Use the [getVeroReasonCodes](/develop/api/sell/vero_api#sell-vero_api-vero_reason_code-getveroreasoncodes) method to retrieve supported VeRO reason code IDs.

### getVeroReasonCodes

#### GET /vero_reason_code
**Description:** **Important!** You must be a member of the Verified Rights Owner (VeRO) Program to use this call.

  
This method is used to retrieve the details of an array of VeRO reason codes. This information includes the descriptions of each code, as well as the marketplace associated with each code.  
  
If the **X-EBAY-C-MARKETPLACE-ID** header is present, only VeRO reason codes for that specific site will be returned. If this header is not included, all reason codes for all sites are returned.
**Parameters:**
- **X-EBAY-C-MARKETPLACE-ID** (string)
  - This header identifies the eBay marketplace for which to retrieve VeRO reason codes. If this header is used, only VeRO reason codes for the specified marketplace will be returned in the response.  
  
See [MarketplaceIdEnum](/develop/api/sell/vero_api#sell-vero_api-vero_reason_code-getveroreasoncodes.veroreasoncode.marketplaceid) for a list of supported values.

### createVeroReport

#### POST /vero_report
**Description:** **Important!** You must be a member of the Verified Rights Owner (VeRO) Program to use this call.

  
This method can be used to create a VeRO report for a listing. VeRO reports can be used to report items that your copyright, trademark, or other intellectual property rights.  
  
The **itemId** of the item being reported must be provided in the request, as well as the **veroReasonCodeId** of the claimed infringement.  
  
You can report one or more items at a time using this method. A maximum of 150 items can be reported using this method.
**Parameters:**
- **Content-Type** (string) *required*
  - This header indicates the format of the request body provided by the client. Its value should be set to **application/json**.  
  
For more information, refer to [HTTP request headers](/api-docs/static/rest-request-components.html#HTTP).

### getVeroReport

#### GET /vero_report/{vero_report_id}
**Description:** **Important!** You must be a member of the Verified Rights Owner (VeRO) Program to use this call.

  
This method can be used to retrieve status information about a VeRO report you have submitted to eBay for copyright, trademark, or other intellectual property rights infringement.  
  
The **vero\_report\_id** path parameter is used to specify the eBay report for which to retrieve status information.
**Parameters:**
- **includeItemDetails** (string)
  - Include this query and set it to `true` if you want to retrieve the **reportedItemDetails** container in the response, which contains item-level status information. This container may be helpful if you have reported violations on more than one eBay item in the report.  
  
By default, this boolean is set to `false`.
- **vero_report_id** (string) *required*
  - This path parameter specifies the unique identifier of the VeRO report being retrieved.  
  
This value is returned when creating a VeRO report through the [createVeroReport](/develop/api/sell/vero_api#sell-vero_api-vero_report-createveroreport) method.

### getVeroReportItems

#### GET /vero_report_items
**Description:** **Important!** You must be a member of the Verified Rights Owner (VeRO) Program to use this call.

  
This method can be used to retrieve status information about one or more VeRO reported items you have submitted.  
  
Without the use of any query parameters, the default behavior of this method is to return the status of all VeRO reported items submitted by the seller during the last two years. Use the **itemId** query parameter to see a specific reported item, and use the **filter** query to retrieve the status of reported items submitted within a specific date range. Pagination is also available to limit the number of reported items that are retrieved per page of data.
**Parameters:**
- **filter** (string)
  - This query parameter can be used to filter the result set by a date range. Only items reported within the specified time period will be returned.  
  
This parameter will be ignored if **itemId** has been specified.  
  
**Format:** `YYYY-MM-DD HH:MM:SS`  
  
**Example**: `reportSubmittedDate:[2024-11-14T07:47:48Z..2024-12-14T07:47:48Z]`.
- **itemId** (string)
  - This query parameter specifies the unique identifier of an eBay listing. Only the specified reported item will be returned.
- **limit** (string)
  - The maximum number of entries that can be returned on each page of the paginated response. Use this parameter in conjunction with the **offset** parameter to control the pagination of the output.  
  
**Note:** This feature employs a zero-based list, where the first item in the list has an offset of `0`.  
For example, if **offset** is set to `10` and **limit** is set to `10`, the call retrieves entries 11 through 20 from the result set.  
  
If this parameter is omitted, the default value is used.  
  
**Default:** 25
- **offset** (string)
  - The number of reports to skip in the result set before returning the first report in the paginated response. Combine offset with the **limit** query parameter to control the reports returned in the response. For example, if you supply an **offset** of `0` and a **limit** of `10`, the first page of the response contains the first 10 reports from the complete list of reports retrieved by the call. If this query parameter is not set, the default value is used and the first page of reports is returned.  
  
**Default:** 0

## Error Codes

The following error codes may be returned by this API:

### REQUEST Errors

#### 235001 - API_VERO
**Description:** The veroReasonCodeId was not found.

#### 235002 - API_VERO
**Description:** Only Registered Verified Rights Owners are allowed. Subscription missing.

#### 235003 - API_VERO
**Description:** Only Registered Verified Rights Owners are allowed. Insufficient subscription level.

#### 235012 - API_VERO
**Description:** Number of reported items exceeds maximum limit of 150 items.

#### 235013 - API_VERO
**Description:** The itemId is required for this call.

#### 235014 - API_VERO
**Description:** The veroReasonCodeId is required for this call.

#### 235015 - API_VERO
**Description:** At least one country is required for the specified reason code.

#### 235016 - API_VERO
**Description:** The Regions specified are not allowed.

#### 235017 - API_VERO
**Description:** The patent is required for this call.

#### 235019 - API_VERO
**Description:** Please verify brand, it should not exceed 50 characters.

#### 235020 - API_VERO
**Description:** The detailedMessage is required for the specified reason code.

#### 235021 - API_VERO
**Description:** Please verify detailedMessage, it should not exceed 1000 characters.

#### 235022 - API_VERO
**Description:** Please verify messageToSeller, it should not exceed 1000 characters.

#### 235023 - API_VERO
**Description:** Please check report, there are duplicate item reports. A duplicate report is two report on the same itemId and veroReasonCodeId combination in one packet. The same combination itemId and veroReasonCodeId can be reported in a different packet.

#### 235024 - API_VERO
**Description:** At least one item is required for this call.

#### 235018 - API_VERO
**Description:** Please verify patent, it should not exceed 15 characters.

#### 235010 - API_VERO
**Description:** Not authorized to perform this operation. Vero report creator and requester are different.

#### 235011 - API_VERO
**Description:** The veroReportId was not found.

#### 235005 - API_VERO
**Description:** A filter supplied in the request is invalid: {filterName}.

#### 235006 - API_VERO
**Description:** The itemId was not found.

#### 235007 - API_VERO
**Description:** Please check the date range.

#### 235009 - API_VERO
**Description:** The time interval specified is greater than what is allowed (90 days is the maximum).

### APPLICATION Errors

#### 235000 - API_VERO
**Description:** There was a problem with an eBay internal system or process.

## Rate Limits

See [API Call Limits](https://developer.ebay.com/develop/get-started/api-call-limits) on the eBay Developer Program.

## Resources

### Documentation

- [eBay Developer Program](https://developer.ebay.com/)
- [API Documentation](https://developer.ebay.com/develop/api/)
- [SDKs and Widgets](https://developer.ebay.com/develop/sdks-and-widgets)
- [Developer Community Forum](https://community.ebay.com/t5/Developer-Groups/ct-p/developergroup)

### Tools

- [API Explorer](https://developer.ebay.com/my/api_test_tool)
- [GraphQL Explorer](https://developer.ebay.com/my/graphql_explorer)

### Support

- [Developer Support](https://developer.ebay.com/support/)
- [API Status](https://developer.ebay.com/support/api-status)
- [Release Notes](https://developer.ebay.com/develop/api/release_notes/)

---
*Generated on 2026-07-08T04:23:55.123Z*