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 OfferService API

The OfferService API from Refurbed — 9 operation(s) for offerservice.

Refurbed OfferService API is one of 18 APIs that Refurbed publishes on the APIs.io network, described by a machine-readable OpenAPI specification.

Tagged areas include OfferService. The published artifact set on APIs.io includes an OpenAPI specification and API documentation.

This API exposes 9 operations across 9 paths, and defines 67 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.

9 operations 9 paths 67 schemas 9 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 OfferService 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 9

Across 9 paths, the API surfaces 9 operations — 9 POST. Each is listed below with its method, path, parameters, and response codes.

OfferService 9
POST
/refb.merchant.v1.OfferService/BatchCreateOffers
Batch creates offers.
BatchCreateOffers body → 200default
POST
/refb.merchant.v1.OfferService/BatchDeleteOffers
Batch deletes offers.
BatchDeleteOffers body → 200default
POST
/refb.merchant.v1.OfferService/BatchGetOffers
Batch gets single offers.
BatchGetOffers body → 200default
POST
/refb.merchant.v1.OfferService/BatchUpdateOffers
Batch updates offers.
BatchUpdateOffers body → 200default
POST
/refb.merchant.v1.OfferService/CreateOffer
Creates a single offer.
CreateOffer body → 200default
POST
/refb.merchant.v1.OfferService/DeleteOffer
Deletes a single offer.
DeleteOffer body → 200default
POST
/refb.merchant.v1.OfferService/GetOffer
Gets a single offer.
GetOffer body → 200default
POST
/refb.merchant.v1.OfferService/ListOffers
Lists all offers.
ListOffers body → 200default
POST
/refb.merchant.v1.OfferService/UpdateOffer
Updates a single offer.
UpdateOffer body → 200default

Schemas 67

The contract defines 67 schemas that model the data the API accepts and returns. The most detailed are Offer (24 properties), BatchCreateOffersRequest.Create (16 properties), ListOffersRequest.Filter (16 properties), OfferMarketPrice (15 properties). Each schema is shown below with its type and property counts.

CurrencyCodeFilter
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…
GetOfferResponse
object
1 property
InstanceDescriptor
object
5 properties 2 required
MatchingHints
object
4 properties
ListOffersResponse
object
2 properties
OptionalInt64Filter
object
3 properties
Create.CreateMarketPrice
object
4 properties 2 required
LanguageCode
string
OfferMarketPrice
object
An offer price defines the price configuration of an offer for a single market.
15 properties
OfferTaxationFilter
object
2 properties
BatchDeleteOffersResponse
object
1 property
ListOffersRequest.Filter
object
16 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
CreateOfferResponse
object
1 property
BatchUpdateOffersRequest.Update
object
12 properties
BatchDeleteOffersRequest
object
1 property 1 required
UpdateOfferResponse
object
1 property
ListOffersRequest.Filter.OfferNameFilter
object
1 property
BatchGetOffersResponse
object
1 property
BatchUpdateOffersResponse
object
1 property
DeleteOfferRequest
object
1 property
SortOrder
string
Int64Pagination
object
Paginates resources with int64 primary key.
3 properties
BatchCreateOffersResponse
object
1 property
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
Offer
object
A merchant's offer.
24 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.
OfferWarrantyFilter
object
2 properties
BatteryConditionFilter
object
3 properties
RejectionReason
object
2 properties
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
UInt32RangeFilter
object
6 properties
OfferGradingFilter
object
2 properties
BatchUpdateOffersResponse.Result
object
2 properties
BatchGetOffersRequest
object
1 property 1 required
BatteryCondition
string
BatchGetOffersRequest.Get
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…
BatchCreateOffersResponse.Result
object
2 properties
OfferStateFilter
object
2 properties
BatchDeleteOffersRequest.Delete
object
1 property
ListOffersRequest.Sort
object
2 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…
RejectionCategory
string
- MISSINGREQUIREMENTS: Some of the mandatory parameters to determine what product the offer describes are missing - CONFIGURATIONDOESNOTEXIST: Product configur…
BatchDeleteOffersResponse.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
TimestampRangeFilter
object
6 properties
UpdateOfferRequest
object
See offer for full documentation.
12 properties
BatchCreateOffersRequest.Create
object
16 properties 4 required
OfferSKUFilter
object
3 properties
GetOfferRequest
object
1 property
ListOffersRequest.Sort.By
string
Int64Filter
object
2 properties
OfferIdentifier
object
2 properties
ListOffersRequest
object
3 properties
BatchGetOffersResponse.Result
object
2 properties
CreateOfferRequest
object
See offer for full documentation.
15 properties 4 required
OfferBuyboxScope
string
BatchUpdateOffersRequest
object
See offer for full documentation.
1 property 1 required
CreateOfferRequest.CreateMarketPrice
object
4 properties 2 required
BuyboxInfo
object
5 properties
Specification
object
2 properties 2 required
CurrencyCode
string
Currency codes as specified in ISO 4217. - AED: XTS = 963; // Code reserved for testing purposes.
BatchCreateOffersRequest
object
See offer for full documentation.
1 property 1 required

Specification

The full machine-readable OpenAPI contract behind this narrative.

Source

refurbed-offerservice-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 MarketOfferService API
Refurbed MarketService API
Refurbed MerchantService API
Refurbed OrderItemReturnService API
Where this information came from

This is an independent, third-party profile of Refurbed OfferService 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.