How AI is applied across API Evangelist and APIs.io. Read my AI disclosure →
API Evangelist API Evangelist
Discovery
Learnings
Guidance
Toolbox
Alignment
API Evangelist LLC

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 3.2.0, at version 1.0.

Requests are made against a single 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.

Specification
OpenAPI 3.2.0
API Version
1.0
Base URL
https://api.refurbed.com
Authentication
API Key
Resource Areas
1

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.
BatchCreateMarketOffer body → 200default
POST
/refb.merchant.v1.MarketOfferService/BatchDeleteMarketOffer
Batch deletes market offers / offer market prices of offers.
BatchDeleteMarketOffer body → 200default
POST
/refb.merchant.v1.MarketOfferService/BatchGetMarketOffer
Batch gets market offers / offer market prices of offers.
BatchGetMarketOffer body → 200default
POST
/refb.merchant.v1.MarketOfferService/BatchUpdateMarketOffer
Batch updates market offers / offer market prices of offers.
BatchUpdateMarketOffer body → 200default
POST
/refb.merchant.v1.MarketOfferService/CreateMarketOffer
Creates a single market offer / an offer market price of an offer.
CreateMarketOffer body → 200default
POST
/refb.merchant.v1.MarketOfferService/DeleteMarketOffer
Deletes a single market offer / an offer market price of an offer.
DeleteMarketOffer body → 200default
POST
/refb.merchant.v1.MarketOfferService/GetMarketOffer
Gets a single market offer.
GetMarketOffer body → 200default
POST
/refb.merchant.v1.MarketOfferService/ListMarketOffers
Lists all market offers.
ListMarketOffers body → 200default
POST
/refb.merchant.v1.MarketOfferService/ListMarketOffersByOffer
Lists all market offers of a specific offer.
ListMarketOffersByOffer body → 200default
POST
/refb.merchant.v1.MarketOfferService/UpdateMarketOffer
Updates a single market offer / an offer market price of an offer.
UpdateMarketOffer body → 200default

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.

CurrencyCodeFilter
object
2 properties
CreateMarketOfferRequest
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
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…
MarketOffer
object
A merchant's market offer. A market offer is a combination of an offer with a specific offer market price.
21 properties
BatchCreateMarketOffersResponse.Result
object
2 properties
ListMarketOffersRequest.Filter.OfferNameFilter
object
1 property
StringPagination
object
Paginates resources with string primary key.
3 properties
ListMarketOffersByOfferRequest.Filter
object
13 properties
CreateMarketOfferRequest.CreateOfferMarketPrice
object
4 properties 2 required
BatchUpdateMarketOffersRequest.Update
object
2 properties
OfferBuyboxScopeFilter
object
2 properties
OptionalInt64Filter
object
3 properties
OfferGradingFilter
object
2 properties
BatchDeleteMarketOffersRequest
object
1 property 1 required
OfferTaxationFilter
object
2 properties
OfferMarketPrice
object
An offer price defines the price configuration of an offer for a single market.
15 properties
ListMarketOffersByOfferResponse
object
2 properties
GetMarketOfferRequest
object
1 property
BatchDeleteMarketOffersRequest.Delete
object
1 property
ListMarketOffersByOfferRequest.Sort.By
string
BatchCreateMarketOffersRequest.Create
object
2 properties
GetMarketOfferResponse
object
1 property
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
ListMarketOffersRequest
object
3 properties
BatchGetMarketOffersResponse.Result
object
2 properties
SortOrder
string
BatchGetMarketOffersRequest
object
1 property 1 required
BatchUpdateMarketOffersResponse
object
1 property
OfferVisibilityFilter
object
2 properties
MarketOfferIdentifierFilter
object
2 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…
OfferTaxation
string
OfferBuyboxStateFilter
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.
BatchCreateMarketOffersRequest
object
1 property 1 required
UInt32RangeFilter
object
6 properties
ListMarketOffersByOfferRequest
object
4 properties
Update.UpdateOfferMarketPrice
object
4 properties
DeleteMarketOfferRequest
object
1 property
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
OfferWarrantyFilter
object
2 properties
ListMarketOffersRequest.Sort
object
2 properties
MarketOfferIdentifier
object
2 properties 1 required
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…
OfferStateFilter
object
2 properties
BatchDeleteMarketOffersResponse
object
1 property
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…
TimestampRangeFilter
object
6 properties
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
BatchGetMarketOffersResponse
object
1 property
UpdateMarketOfferRequest.UpdateOfferMarketPrice
object
4 properties
BatchUpdateMarketOffersResponse.Result
object
2 properties
OfferSKUFilter
object
3 properties
MarketOfferIdentifierPagination
object
Paginates resources with market offer identifier key.
3 properties
UpdateMarketOfferResponse
object
1 property
BatchUpdateMarketOffersRequest
object
1 property 1 required
OfferIdentifier
object
2 properties
ListMarketOffersResponse
object
2 properties
CreateMarketOfferResponse
object
1 property
BatchCreateMarketOffersResponse
object
1 property
BatchDeleteMarketOffersResponse.Result
object
1 property
UpdateMarketOfferRequest
object
2 properties
OfferBuyboxScope
string
StringFilter
object
2 properties
ListMarketOffersByOfferRequest.Sort
object
2 properties
Int64Filter
object
2 properties
Create.CreateOfferMarketPrice
object
4 properties 2 required
ListMarketOffersRequest.Filter
object
28 properties
BuyboxInfo
object
5 properties
ListMarketOffersRequest.Sort.By
string
CurrencyCode
string
Currency codes as specified in ISO 4217. - AED: XTS = 963; // Code reserved for testing purposes.
BoolFilter
object
1 property
BatchGetMarketOffersRequest.Get
object
1 property

Specification

The full machine-readable OpenAPI contract behind this narrative.

Source

refurbed-marketofferservice-api-openapi.yml Raw ↑

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
Where this information came from

This is an independent, third-party profile of Refurbed MarketOfferService API, published by API Evangelist. We do not operate, host, resell, or support these APIs, and we are not affiliated with or endorsed by the company unless stated above. Everything here is built from publicly available information — the company's own site, developer portal, documentation, public repositories, and the specifications it publishes for public use. Nothing is obtained by breaching a system, defeating an access control, or using credentials.

The Kin Score and Agent Readiness rating are independently calculated assessments of a company's public API artifacts, scored against a published rubric. They are not certifications, endorsements, security assessments, or audits.

Corrections, re-scores, and removal are free — no partnership or purchase required, and you do not need to justify the request. A removed company is recorded as unrated, never scored zero for having asked. Acknowledgement within one business day; removal within two.

info@apievangelist.com · Read the full data-sourcing policy →
On a security or compliance team? Put security in the subject line and you will get a person, not a form — we will tell you exactly which public URLs this profile was built from.