Need help with your APIs? I offer API discovery, governance & evangelism services. Explore services →
API Evangelist API Evangelist
Discovery
Learnings
Guidance
Toolbox
Alignment
API Evangelist LLC

Newstore Reason Codes API

Reason Codes API.

Newstore Reason Codes API is one of 42 APIs that Newstore publishes on the APIs.io network, described by a machine-readable OpenAPI specification.

Tagged areas include Reason Codes. The published artifact set on APIs.io includes an OpenAPI specification, an API reference, and API documentation.

This API exposes 5 operations across 2 paths, and defines 7 schemas. It is described by OpenAPI 2.0, at version 1.0.

Requests are made against the base URL https://dodici-demo.p.newstore.net.

5 operations 2 paths 7 schemas 1 DELETE2 GET1 PATCH1 POST

Metadata

The identity and technical contract details declared by the specification.

Specification
OpenAPI 2.0
API Version
1.0
Base URL
https://dodici-demo.p.newstore.net
Authentication
OAuth 2.0
Resource Areas
1

Authentication & Security 1

Newstore Reason Codes API declares 1 security scheme for authenticating requests. It supports OAuth 2.0 (oauth) using the application flow, exposing 29 scopes.

Paths & Operations 5

Across 2 paths, the API surfaces 5 operations — 1 DELETE, 2 GET, 1 PATCH, 1 POST. Each is listed below with its method, path, parameters, and response codes.

Reason Codes 5

Reason Codes API.

GET
/promotions/reason-codes
listReasonCodes
listReasonCodes 2 params → default200400401403404429500
POST
/promotions/reason-codes
createReasonCode
createReasonCode 4 params → default201400401403409429500
DELETE
/promotions/reason-codes/{code}
destroyReasonCode
destroyReasonCode 3 params → default204401403404429500502
GET
/promotions/reason-codes/{code}
showReasonCode
showReasonCode 2 params → default200401403404429500502
PATCH
/promotions/reason-codes/{code}
updateReasonCode
updateReasonCode 5 params → default204400401403404429500

Schemas 7

The contract defines 7 schemas that model the data the API accepts and returns. The most detailed are Problem (9 properties), LocalizedReasonCode (3 properties), Localization (2 properties), GetResponse (2 properties). Each schema is shown below with its type and property counts.

ReasonCodePatch
object
1 property 1 required
Problem
object
9 properties
ReasonCodeInit
object
2 properties 2 required
ListResponse
object
1 property 1 required
LocalizedReasonCode
object
3 properties 3 required
GetResponse
object
2 properties 2 required
Localization
object
2 properties 2 required

Specification

The full machine-readable OpenAPI contract behind this narrative.

Source

newstore-reason-codes-api-openapi.yml Raw ↑

Other APIs Newstore publishes across the network.

Newstore address API
Newstore audit-events API
Newstore cart API
Newstore cashboxes API
Newstore customer-configuration API
Newstore customer-profile API
Newstore customerProfile API
Newstore data API
Newstore EasypostAdapterConfig API
Newstore external-public API
Newstore fulfillment-requests API
Newstore identity-providers API