Amazon Selling Partner API

Use the @bijection/connectors/amazon-selling-partner entrypoint to declare Amazon Selling Partner API resources.

Availability

This page describes the pinned source package. Published availability is unestablished for this artifact. Source build and package availability.

Resources and modes

Resource	Mode	Description
Orders	`pull`	Fixed LastUpdated windows paged by NextToken

Declare a resource in application code, then bind deployment-specific settings and credentials. See typed resources, connections and source inspection.

Orders

pull: Fixed LastUpdated windows paged by NextToken

The following example matches configuration standard.

import { amazonSellingPartner } from "@bijection/connectors/amazon-selling-partner";
export const orders = amazonSellingPartner.orders.pull();

Inferred record types

Resource without an operational record table

Configuration: standard

Case: amazon-selling-partner/orders/pull/standard. Connection and resource configuration are declared by this exact case. Credential kind: amazon-selling-partner. Keep credential material in the private credential inventory.

Setting	Type	Required	Owner
`region`	string	Yes	Shared connection
`marketplaceIds`	string	Yes	Resource binding

Complete configuration contract

{
  "setup": [],
  "resource": {
    "access": {},
    "defaults": {},
    "connector": "amazon-selling-partner",
    "output": {
      "kind": "single",
      "collection": "orders"
    },
    "credential_kind": "amazon-selling-partner",
    "connection_fields": [
      "region"
    ],
    "address": {
      "kind": "setup",
      "field": "region",
      "prefix": "https://sellingpartnerapi-",
      "suffix": ".amazon.com"
    }
  },
  "connection_setup": {
    "type": "object",
    "value": {
      "region": {
        "fieldType": {
          "type": "string"
        },
        "optional": false
      },
      "marketplaceIds": {
        "fieldType": {
          "type": "string"
        },
        "optional": false
      }
    }
  },
  "execution": null
}

Native admission analysis is available for this exact declaration. Collection: orders

Contract	Meaning
Initial	Enumeration of observed records
Changes	Repeated observations of current records
Deletions	Deletion detection unsupported
Resume	Opaque cursor
Gap	Explicit repair required after a gap
Retention	Unspecified

Complete native profile

{
  "movement": {
    "exchanges": {
      "next": {
        "200": {
          "placement": "retained_bytes",
          "interpretation": "json",
          "projectsBeforeRetention": false,
          "retainedBodyLimitBytes": "524288",
          "fileLimitBytes": null
        },
        "429": {
          "placement": "retained_bytes",
          "interpretation": "opaque",
          "projectsBeforeRetention": false,
          "retainedBodyLimitBytes": "524288",
          "fileLimitBytes": null
        }
      },
      "window": {
        "200": {
          "placement": "retained_bytes",
          "interpretation": "json",
          "projectsBeforeRetention": false,
          "retainedBodyLimitBytes": "524288",
          "fileLimitBytes": null
        },
        "429": {
          "placement": "retained_bytes",
          "interpretation": "opaque",
          "projectsBeforeRetention": false,
          "retainedBodyLimitBytes": "524288",
          "fileLimitBytes": null
        }
      }
    },
    "nativeInputLimitBytes": null,
    "steps": [
      {
        "id": "acquire.1",
        "inputs": [],
        "action": {
          "operation": "acquire",
          "subject": "exchange next",
          "limitBytes": null
        }
      },
      {
        "id": "acquire.2",
        "inputs": [],
        "action": {
          "operation": "acquire",
          "subject": "exchange window",
          "limitBytes": null
        }
      },
      {
        "id": "retain.1",
        "inputs": [
          "acquire.1",
          "acquire.2"
        ],
        "action": {
          "operation": "retain",
          "subject": "acquisition evidence",
          "reason": "recovery",
          "release": "acquisition_custody"
        }
      },
      {
        "id": "interpret.1",
        "inputs": [
          "retain.1"
        ],
        "action": {
          "operation": "interpret",
          "subject": "acquired input",
          "produces": "records"
        }
      },
      {
        "id": "materialize.1",
        "inputs": [
          "interpret.1"
        ],
        "action": {
          "operation": "materialize",
          "subject": "source rows",
          "reason": "serving",
          "release": "replacement"
        }
      },
      {
        "id": "publish.1",
        "inputs": [
          "materialize.1"
        ],
        "action": {
          "operation": "publish",
          "subject": "source rows",
          "visibility": "with_acquisition"
        }
      }
    ]
  },
  "initial": "enumeration",
  "changes": "observations",
  "deletions": "unsupported",
  "resume": "opaque_cursor",
  "retentionMs": null,
  "gap": "explicit_repair",
  "limits": {
    "http_response_bytes": "524288"
  },
  "restrictions": [],
  "commands": {}
}

Commands, occurrences and artifacts

{
  "records": {
    "orders": {
      "protocol": "record_observation",
      "coverage": "records",
      "consistency": "observations",
      "atomicity": "record",
      "history": "observations",
      "recordRefresh": false,
      "reconciliation": false,
      "notifications": false,
      "snapshotMaxRows": null,
      "profile": {
        "movement": {
          "exchanges": {
            "next": {
              "200": {
                "placement": "retained_bytes",
                "interpretation": "json",
                "projectsBeforeRetention": false,
                "retainedBodyLimitBytes": "524288",
                "fileLimitBytes": null
              },
              "429": {
                "placement": "retained_bytes",
                "interpretation": "opaque",
                "projectsBeforeRetention": false,
                "retainedBodyLimitBytes": "524288",
                "fileLimitBytes": null
              }
            },
            "window": {
              "200": {
                "placement": "retained_bytes",
                "interpretation": "json",
                "projectsBeforeRetention": false,
                "retainedBodyLimitBytes": "524288",
                "fileLimitBytes": null
              },
              "429": {
                "placement": "retained_bytes",
                "interpretation": "opaque",
                "projectsBeforeRetention": false,
                "retainedBodyLimitBytes": "524288",
                "fileLimitBytes": null
              }
            }
          },
          "nativeInputLimitBytes": null,
          "steps": [
            {
              "id": "acquire.1",
              "inputs": [],
              "action": {
                "operation": "acquire",
                "subject": "exchange next",
                "limitBytes": null
              }
            },
            {
              "id": "acquire.2",
              "inputs": [],
              "action": {
                "operation": "acquire",
                "subject": "exchange window",
                "limitBytes": null
              }
            },
            {
              "id": "retain.1",
              "inputs": [
                "acquire.1",
                "acquire.2"
              ],
              "action": {
                "operation": "retain",
                "subject": "acquisition evidence",
                "reason": "recovery",
                "release": "acquisition_custody"
              }
            },
            {
              "id": "interpret.1",
              "inputs": [
                "retain.1"
              ],
              "action": {
                "operation": "interpret",
                "subject": "acquired input",
                "produces": "records"
              }
            },
            {
              "id": "materialize.1",
              "inputs": [
                "interpret.1"
              ],
              "action": {
                "operation": "materialize",
                "subject": "source rows",
                "reason": "serving",
                "release": "replacement"
              }
            },
            {
              "id": "publish.1",
              "inputs": [
                "materialize.1"
              ],
              "action": {
                "operation": "publish",
                "subject": "source rows",
                "visibility": "with_acquisition"
              }
            }
          ]
        },
        "initial": "enumeration",
        "changes": "observations",
        "deletions": "unsupported",
        "resume": "opaque_cursor",
        "retentionMs": null,
        "gap": "explicit_repair",
        "limits": {
          "http_response_bytes": "524288"
        },
        "restrictions": [],
        "commands": {}
      }
    }
  },
  "occurrences": null,
  "artifacts": {
    "raw_archive": false,
    "native_file_transfer_limit_bytes": null,
    "external_versions": false,
    "files": {}
  },
  "commands": {}
}

Recorded checks

Requirement	Scope	Evidence	Result
page-publication-recovery	{“kind”:“collection”,“name”:“orders”}	Native test: integrations/acquisition/acquisition_windows_preserve_sequences_and_restart_fences_old_work (shared_engine)	Execution result unavailable
stated-cursor-empty-page-advances	{“kind”:“collection”,“name”:“orders”}	No check exercises this packaged Amazon Selling Partner API declaration against Amazon Selling Partner API; it has not run or been qualified.	Execution result unavailable
stated-cursor-repeat-refused	{“kind”:“collection”,“name”:“orders”}	No check exercises this packaged Amazon Selling Partner API declaration against Amazon Selling Partner API; it has not run or been qualified.	Execution result unavailable
backoff-stated-wait	{“kind”:“connection”}	Native test: integrations/acquisition/backoff_a_stated_wait_defers_the_next_dispatch_and_then_resumes (shared_engine)	Execution result unavailable
budget-shared	{“kind”:“connection”}	Native test: integrations/acquisition/budget_one_bucket_is_spent_by_a_collection_and_by_a_command (shared_engine)	Execution result unavailable
identity-account	{“kind”:“connection”}	Fixture: ./src/connectors/amazon-selling-partner/fixtures/identity.json	passed (2026-10-24T21:36:11.982Z)

Hosted qualification: unestablished for this catalog configuration. Installed connections report their own identity, authority and current status.

Provider guidance

Compiled declaration examples and configuration details are published in the connector reference. The connection dials the regional endpoint https://sellingpartnerapi-{region}.amazon.com (region setup: na, eu or fe) and reads the marketplaceIds setup (comma-separated). The credential is an OAuth refresh envelope over the seller’s Login with Amazon (LWA) refresh token. SP-API takes the access token in x-amz-access-token with no scheme, so the envelope’s token protocol sets bearer_header; without it the engine sends Authorization: Bearer, which SP-API refuses:

{
  "kind": "oauth_refresh",
  "protocol": { "bearer_header": "x-amz-access-token" },
  "token_endpoint": "https://api.amazon.com/auth/o2/token",
  "client_id": "amzn1.application-oa2-client.…",
  "client_secret": "…",
  "refresh_token": "Atzr|…",
  "refresh_context": { "kind": "none" },
  "allowed_resource_origins": ["https://sellingpartnerapi-na.amazon.com"]
}

The Sellers API names marketplaces, not the seller, so the connection asserts no account identity. orders.pull reads Orders API v0 getOrders in one fixed window [LastUpdatedAfter, LastUpdatedBefore] per pass, fixed on its first page three minutes before the clock (Amazon requires two) and paged by NextToken, 100 an answer. The first pass reaches back two years; a finished pass carries the window’s end and the next begins five minutes before it. Re-read orders deduplicate by LastUpdateDate. OrderStatus is kept as stated; OrderTotal.Amount is exact decimal text with its CurrencyCode. getOrders is a burst of 20 and one a minute, declared as the connection’s token bucket. Not built: buyer and address fields need a restricted data token, which no credential envelope mints; Orders v2026-01-01; the Reports API (a report document is a gzipped tab-separated file at a presigned storage address, outside the connection’s origin and the provider-job result contract); notifications (SQS or EventBridge destinations only); writes. Nothing here has run against Amazon or been qualified; the bearer_header presentation is unit-tested in the engine only.

Provider references

Provider references and prerequisites are maintained in the connector guidance above. No separate provider-documentation review date is recorded.

Source and evidence

Canonical connector source, native analysis and check receipts. Connector artifact: 905888ea276a2a28e36981a79e8142b2547ea451c3e63162cb6915ad4a7d1305. The resource declaration examples above are compiled and compared with exact catalog declarations. Recorded checks apply only to their source, declaration and runtime identities. Configure a connection and inspect its status to establish deployment-specific readiness.

Get Started

Use-case atlas

Platform

Data and Operations

Guides

Client Libraries

Tools

API Reference

Amazon Selling Partner API

Availability

Resources and modes

Orders

pull: Fixed LastUpdated windows paged by NextToken

Configuration: standard

Provider guidance

Provider references

Source and evidence

​Availability

​Resources and modes

​Orders

​pull: Fixed LastUpdated windows paged by NextToken

​Configuration: standard

​Provider guidance

​Provider references

​Source and evidence

Availability

Resources and modes

Orders

pull: Fixed LastUpdated windows paged by NextToken

Configuration: standard

Provider guidance

Provider references

Source and evidence