{"registry_version":"2026.1025.387","generated_at":"2026-10-25T06:27:00Z","content_sha256":"089d16f627d9365e3d0663cc8069203706d7cb23a76c332226e29686968811a5","signed":true,"signature":{"key_id":"ed25519:74ca19268e364242","algorithm":"ed25519","expires_at":"2026-11-24T06:27:09Z","expired":false,"manifest":"/registry/manifest.json"},"id":"amazon/selling-partner-api","name":"Amazon Selling Partner API (SP-API) developer registration","vendor":"Amazon","status":"researched","last_verified":null,"last_researched":"2026-10-25","summary":"Create a Solution Provider Portal account with identity verification (documents plus a video call), submit a developer profile (private or public, roles, use cases, security controls) for Amazon's review, then register an app client to get Login with Amazon (LWA) credentials and self-authorize to get a refresh token.","account_model":{"summary":"A Solution Provider Portal account (linked to an Amazon login and verified business) holds one developer profile that sets private or public data access and approved roles. App clients registered under it get LWA credentials; each selling partner account that authorizes an app yields a refresh token.","accounts":[{"name":"Amazon login (primary user)","kind":"personal","owned_by":"the person","required":true,"note":"App registration and self-authorization need the primary account user."},{"name":"Solution Provider Portal account","kind":"organisation","owned_by":"the business","parent":"Amazon login (primary user)","required":true,"note":"Identity verification is done by the administrator for themselves and the company."},{"name":"Developer profile","kind":"developer","parent":"Solution Provider Portal account","required":true,"note":"Private (own business only) or public (Appstore apps serving other sellers); roles decide which APIs and data you can use."},{"name":"App client","kind":"project","parent":"Developer profile","required":true,"note":"Has an LWA client ID and client secret; secret must be rotated every 180 days."},{"name":"Seller Central or Vendor Central account","kind":"other","required":false,"note":"The selling account whose data the app reads; it authorizes the app and yields a refresh token."}],"notes":["A professional selling account is not needed to develop against SP-API from the Solution Provider Portal.","Restricted roles (PII, e.g. buyer names and addresses) add a three-stage review including a call with an Amazon solution architect."]},"prerequisites":[],"identity_requires":[],"have_ready":[{"kind":"government_id","description":"Government-issued photo ID or passport of the primary contact, scanned, plus the original for the video call","why":null,"needed_for":["verify-identity"],"auto_check":"none","source_url":"https://developer-docs.amazon/sp-api/docs/onboarding-step-2-create-an-spp-account"},{"kind":"proof_of_address","description":"Recent bank or credit card statement as proof of address","why":null,"needed_for":["verify-identity"],"auto_check":"none","source_url":"https://developer-docs.amazon/sp-api/docs/onboarding-step-2-create-an-spp-account"},{"kind":"company_documents","description":"Business licence (if applicable), company registration number and registered business address","why":null,"needed_for":["verify-identity"],"auto_check":"name_consistency","source_url":"https://developer-docs.amazon/sp-api/docs/onboarding-step-2-create-an-spp-account"},{"kind":"phone_for_2fa","description":"Phone to receive a PIN by SMS or call during verification","why":null,"needed_for":["verify-identity"],"auto_check":"none","source_url":"https://developer-docs.amazon/sp-api/docs/onboarding-step-2-create-an-spp-account"},{"kind":"other","description":"A device with a video camera for the identity verification video call","why":null,"needed_for":["verify-identity"],"auto_check":"none","source_url":"https://developer-docs.amazon/sp-api/docs/onboarding-step-2-create-an-spp-account"},{"kind":"live_website","description":"Public HTTPS website describing your services to Amazon sellers, with privacy policy, terms of service and contact details (public developers)","why":"Inaccessible, under-construction, login-only or insecure sites are not accepted.","needed_for":["developer-profile"],"auto_check":"website_live","source_url":"https://developer-docs.amazon/sp-api/docs/register-as-a-public-developer"},{"kind":"other","description":"Written use cases and security-control answers (free text under 500 characters) matching how you meet the AUP and Data Protection Policy","why":null,"needed_for":["developer-profile"],"auto_check":"none","source_url":"https://developer-docs.amazon/sp-api/docs/register-as-a-public-developer"}],"steps":[{"id":"spp-register","title":"Register for the Solution Provider Portal","summary":"Sign in with your Amazon login, choose Register, acknowledge the setup terms, enrol your Amazon account and pick \"Build applications that use SP APIs\". You press each button yourself.","route":"guided","gate":"human_terms","human_only":true,"gate_label":"You accept the terms","depends_on":[],"optional":false,"url":"https://solutionproviderportal.amazon.com/","lead_time":null,"preflight":[],"captures":null},{"id":"verify-identity","title":"Verify your identity (documents and video call)","summary":"Enter business details, verify your phone with a PIN, upload proof of identity and address, then join a video call with an Amazon employee and show your photo ID. verapli never uploads documents.","route":"guided","gate":"human_identity","human_only":true,"gate_label":"You prove your identity","depends_on":["spp-register"],"optional":false,"url":"https://solutionproviderportal.amazon.com/","lead_time":null,"preflight":[],"captures":null},{"id":"developer-profile","title":"Submit the developer profile (private or public)","summary":"Under Develop Apps, complete contact information, data access (private or public), roles, use cases and security controls, accept the Solution Provider Portal Agreement, Acceptable Use Policy and Data Protection Policy, and register. Amazon opens a case with next steps.","route":"guided","gate":"third_party_review","human_only":true,"gate_label":"The provider reviews it","depends_on":["verify-identity"],"optional":false,"url":"https://solutionproviderportal.amazon.com/","lead_time":{"official":{"text":"Review for standard (non-restricted) roles typically takes one to two weeks; restricted PII roles go through a longer three-stage review (no time given).","source_url":"https://developer-docs.amazon/sp-api/docs/onboarding-step-3-create-a-developer-profile","source_title":"SP-API onboarding Step 3: Create a developer profile"},"reported":null,"typical_minutes":null},"preflight":[],"captures":null},{"id":"register-app","title":"Register an app client","summary":"As primary user, open Develop Apps, choose \"Add new app client\", select the API type and seller and/or vendor, and save.","route":"guided","gate":"human_submit","human_only":true,"gate_label":"You press submit","depends_on":["developer-profile"],"optional":false,"url":"https://solutionproviderportal.amazon.com/","lead_time":null,"preflight":[],"captures":null},{"id":"lwa-credentials","title":"Copy the LWA client ID and client secret","summary":"View the app's LWA credentials in the Solution Provider Portal (or Seller/Vendor Central). verapli captures the secret by selector.","route":"copilot","gate":"none","human_only":false,"gate_label":null,"depends_on":["register-app"],"optional":false,"url":"https://solutionproviderportal.amazon.com/","lead_time":null,"preflight":[],"captures":"SP_API_LWA_CLIENT_SECRET"},{"id":"self-authorize","title":"Self-authorize the app to get a refresh token","summary":"As Primary User of the selling account, choose \"Authorize app\" to generate a refresh token. Public apps instead get tokens through the OAuth authorization flow with each seller.","route":"copilot","gate":"human_submit","human_only":true,"gate_label":"You press submit","depends_on":["register-app"],"optional":false,"url":"https://solutionproviderportal.amazon.com/","lead_time":null,"preflight":[],"captures":"SP_API_REFRESH_TOKEN"}],"gates":[{"step":"spp-register","gate":"human_terms","label":"You accept the terms"},{"step":"verify-identity","gate":"human_identity","label":"You prove your identity"},{"step":"developer-profile","gate":"third_party_review","label":"The provider reviews it"},{"step":"register-app","gate":"human_submit","label":"You press submit"},{"step":"self-authorize","gate":"human_submit","label":"You press submit"}],"lead_times":[{"step":"developer-profile","what":"Submit the developer profile (private or public)","official":{"text":"Review for standard (non-restricted) roles typically takes one to two weeks; restricted PII roles go through a longer three-stage review (no time given).","source_url":"https://developer-docs.amazon/sp-api/docs/onboarding-step-3-create-a-developer-profile","source_title":"SP-API onboarding Step 3: Create a developer profile"},"reported":null}],"outputs":[{"name":"SP_API_LWA_CLIENT_ID","description":"Login with Amazon client ID of the app client","secret":false,"example_format":"amzn1.application-oa2-client.…","environments":null},{"name":"SP_API_LWA_CLIENT_SECRET","description":"Login with Amazon client secret (rotate every 180 days)","secret":true,"example_format":null,"environments":null},{"name":"SP_API_REFRESH_TOKEN","description":"Long-lived refresh token for one authorized selling account","secret":true,"example_format":"Atzr|…","environments":null}],"renewals":[{"what":"Rotate the LWA client secret for every app","every":"180 days","every_days":180,"source_url":"https://developer-docs.amazon/sp-api/docs/rotating-your-apps-lwa-credentials"}],"estimated_minutes":null,"guide_url":"https://verapli.com/guides/amazon/selling-partner-api"}