Refurbed MarketOfferService API
The MarketOfferService API from Refurbed — 10 operation(s) for marketofferservice.
Refurbed MarketOfferService API is one of 18 APIs that Refurbed publishes on the APIs.io network, described by a machine-readable OpenAPI specification.
Tagged areas include MarketOfferService. The published artifact set on APIs.io includes an OpenAPI specification and API documentation.
This API exposes 10 operations across 10 paths, and defines 74 schemas. It is described by OpenAPI 2.0, at version 1.0.
Requests are made against the base URL https://api.refurbed.com.
10 operations
10 paths
74 schemas
10 POST
Metadata
The identity and technical contract details declared by the specification.
Authentication & Security 1
Refurbed MarketOfferService API declares
1 security scheme
for authenticating requests.
An API key is passed in the header as Authorization (APIKeyAuth).
By default, every request must be authenticated.
Paths & Operations 10
Across 10 paths, the API surfaces 10 operations — 10 POST. Each is listed below with its method, path, parameters, and response codes.
MarketOfferService 10
POST
/refb.merchant.v1.MarketOfferService/BatchCreateMarketOffer
Batch creates market offers / offer market prices of offers.
POST
/refb.merchant.v1.MarketOfferService/BatchDeleteMarketOffer
Batch deletes market offers / offer market prices of offers.
POST
/refb.merchant.v1.MarketOfferService/BatchGetMarketOffer
Batch gets market offers / offer market prices of offers.
POST
/refb.merchant.v1.MarketOfferService/BatchUpdateMarketOffer
Batch updates market offers / offer market prices of offers.
POST
/refb.merchant.v1.MarketOfferService/CreateMarketOffer
Creates a single market offer / an offer market price of an offer.
POST
/refb.merchant.v1.MarketOfferService/DeleteMarketOffer
Deletes a single market offer / an offer market price of an offer.
POST
/refb.merchant.v1.MarketOfferService/GetMarketOffer
Gets a single market offer.
POST
/refb.merchant.v1.MarketOfferService/ListMarketOffers
Lists all market offers.
POST
/refb.merchant.v1.MarketOfferService/ListMarketOffersByOffer
Lists all market offers of a specific offer.
POST
/refb.merchant.v1.MarketOfferService/UpdateMarketOffer
Updates a single market offer / an offer market price of an offer.
Schemas 74
The contract defines 74 schemas that model the data the API accepts and returns. The most detailed are ListMarketOffersRequest.Filter (28 properties), MarketOffer (21 properties), OfferMarketPrice (15 properties), ListMarketOffersByOfferRequest.Filter (13 properties). Each schema is shown below with its type and property counts.
OfferState
string
- OK: Everything is in order. Final state. - UNVERIFIED: Offer needs to be verified in the refurbed merchant interface before being shown publicly. This state…
BatchDeleteMarketOffersResponse.Result
object
1 property
NumericRangeFilter
object
Numeric range filter is used for decimal numbers. It is especially used for monetary amounts and other quantities where exactness is required.
6 properties
BatchUpdateMarketOffersResponse.Result
object
2 properties
BatchUpdateMarketOffersRequest
object
1 property
1 required
BatchGetMarketOffersRequest.Get
object
1 property
BatchCreateMarketOffersResponse
object
1 property
OfferWarranty
string
The warranty the merchant provides to the customer. Only 12 months is supported. - M12: 12 months. - M18: 18 months, deprecated. Only 12 months is supported fo…
CreateMarketOfferRequest
object
2 properties
OfferTaxationFilter
object
2 properties
OfferVisibilityFilter
object
2 properties
CreateMarketOfferRequest.CreateOfferMarketPrice
object
4 properties
2 required
ListMarketOffersByOfferRequest.Sort.By
string
UpdateMarketOfferRequest
object
2 properties
OfferGrading
string
The grading of the item being sold. Please consult the refurbed seller guide and quality charta to learn about refurbed's grading requirements.
BatchCreateMarketOffersResponse.Result
object
2 properties
BoolFilter
object
1 property
ListMarketOffersByOfferRequest.Filter
object
13 properties
OfferBuyboxState
string
- WON: Offer currently has the BuyBox. - SHOULDWIN: Current offer configuration should win the BuyBox on next refresh. - ELIGIBLE: Offer currently does not hav…
OptionalNumericRangeFilter
object
Numeric range filter is used for decimal numbers. It is especially used for monetary amounts and other quantities where exactness is required.
7 properties
UpdateMarketOfferResponse
object
1 property
BatchCreateMarketOffersRequest.Create
object
2 properties
ListMarketOffersResponse
object
2 properties
BatchDeleteMarketOffersResponse
object
1 property
OfferStateFilter
object
2 properties
BatchGetMarketOffersRequest
object
1 property
1 required
BatchDeleteMarketOffersRequest.Delete
object
1 property
OfferBuyboxScope
string
MarketOfferIdentifierFilter
object
2 properties
Any
object
Any contains an arbitrary serialized protocol buffer message along with a URL that describes the type of the serialized message. Protobuf library provides supp…
1 property
MarketOffer
object
A merchant's market offer. A market offer is a combination of an offer with a specific offer market price.
21 properties
ListMarketOffersByOfferRequest.Sort
object
2 properties
SortOrder
string
BuyboxInfo
object
5 properties
Update.UpdateOfferMarketPrice
object
4 properties
UInt32RangeFilter
object
6 properties
OptionalInt64Filter
object
3 properties
OfferGradingFilter
object
2 properties
Status
object
The Status type defines a logical error model that is suitable for different programming environments, including REST APIs and RPC APIs. It is used by [gRPC](h…
3 properties
BatchUpdateMarketOffersRequest.Update
object
2 properties
GetMarketOfferRequest
object
1 property
OfferMarketPrice
object
An offer price defines the price configuration of an offer for a single market.
15 properties
ListMarketOffersRequest.Sort
object
2 properties
TimestampRangeFilter
object
6 properties
OfferBuyboxStateFilter
object
2 properties
ListMarketOffersRequest.Filter.OfferNameFilter
object
1 property
MarketOfferIdentifier
object
2 properties
1 required
OfferSKUFilter
object
3 properties
OfferVisibility
string
Indicates if and how an offer is shown on the refurbed platform. - FULL: Offer is normally shown to customers. - NONE: Offer is not shown to customers (e.g. do…
ListMarketOffersRequest.Filter
object
28 properties
BatchUpdateMarketOffersResponse
object
1 property
GetMarketOfferResponse
object
1 property
OfferTaxation
string
UpdateMarketOfferRequest.UpdateOfferMarketPrice
object
4 properties
BatchDeleteMarketOffersRequest
object
1 property
1 required
BatchCreateMarketOffersRequest
object
1 property
1 required
BatchGetMarketOffersResponse.Result
object
2 properties
DeleteMarketOfferRequest
object
1 property
BatchGetMarketOffersResponse
object
1 property
OfferIdentifier
object
2 properties
CurrencyCode
string
Currency codes as specified in ISO 4217. - AED: XTS = 963; // Code reserved for testing purposes.
StringFilter
object
2 properties
Int64Filter
object
2 properties
ListMarketOffersByOfferRequest
object
4 properties
StringPagination
object
Paginates resources with string primary key.
3 properties
OfferBuyboxScopeFilter
object
2 properties
OfferWarrantyFilter
object
2 properties
MarketOfferIdentifierPagination
object
Paginates resources with market offer identifier key.
3 properties
CurrencyCodeFilter
object
2 properties
ListMarketOffersRequest
object
3 properties
Create.CreateOfferMarketPrice
object
4 properties
2 required
CreateMarketOfferResponse
object
1 property
ListMarketOffersRequest.Sort.By
string
ListMarketOffersByOfferResponse
object
2 properties
Specification
The full machine-readable OpenAPI contract behind this narrative.
Source
More from Refurbed 12
Other APIs Refurbed publishes across the network.
Refurbed BuybackBidService API
Refurbed BuybackOrderItemService API
Refurbed BuybackOrderService API
Refurbed BuybackProductService API
Refurbed BuybackSupplyboxService API
Refurbed CatalogService API
Refurbed CurrencyService API
Refurbed InstanceService API
Refurbed MarketService API
Refurbed MerchantService API
Refurbed OfferService API
Refurbed OrderItemReturnService API
#MarketOfferService