Madeiramadeira

MadeiraMadeira (MadeiraMadeira Comercio Eletronico S/A, Curitiba, Parana) is one of Brazil's largest online retailers and marketplaces for home goods - furniture, decor, appliances, building materials, bathroom and kitchen fixtures, and planned furniture - selling direct and through a third-party seller marketplace. Its developer surface is the seller-facing Marketplace MadeiraMadeira API: a versioned REST API over HTTPS at marketplace.madeiramadeira.com.br with a matching sandbox host, authenticated with a seller-bound TOKENMM header token issued in the Portal Marketplace. It covers product catalog submission and enrichment lifecycle, the category tree, price, stock and status updates, shipping (frete) tables plus a seller-hosted shipping-quote callback, the full order lifecycle from new through invoiced, shipped and delivered, financial ledger entries, and a JWT-authenticated Mensageria surface for buyer-seller messaging, attachments and tracking updates. Order and product events are delivered to seller-registered callback URLs.

Madeiramadeira publishes 7 APIs on the APIs.io network, including Callbacks API, Categorias API, Financeiro API, and 4 more. Tagged areas include Company, E-Commerce, Marketplace, Retail, and Home Goods.

The Madeiramadeira catalog on APIs.io includes 1 event-driven AsyncAPI specification.

Madeiramadeira’s developer surface includes documentation, API reference, getting-started guide, signup flow, support, engineering blog, and 16 more developer resources.

🌐 Visit website 📡 Source on GitHub

34.1/100 thin ▬ flat Agent 34/100 agent ready saas Full breakdown ↓
scored 2026-09-02 · rubric v0.18.0

AccessSelf serve

7 APIs

Company E-Commerce Marketplace Retail Home Goods Furniture Brazil Seller Integration Product Catalog Order Shipping Logistics

What this lets a business do 1

Business capabilities this provider's published APIs can perform, derived from its own contracts. Browse all capabilities →

Supply Chain Management

BC-520

Pedido

PUT /v1/pedido/received PUT /v1/pedido/invoiced PUT /v1/pedido/shipped PUT /v1/pedido/delivered

Kin Score

Kin Score How this is scored →
scored 2026-09-02 · rubric v0.18.0

Composite quality — 34.1/100 · thin

Contract Quality 5.9 / 25

Developer Ergonomics 11.1 / 20

Access Clarity 6.8 / 20

Operational Transparency 2.4 / 13

Contract Governance 0.5 / 12

Discoverability 7.4 / 10

Agent readiness — 34/100 · agent ready

Machine-Readable Contract 18 / 18

Agentic Access Contract 0 / 10

Documented Reversibility 0 / 6

MCP Server 0 / 12

Machine-Readable Auth 10 / 10

Idempotency 0 / 9

Stable Error Semantics 8 / 8

Request/Response Examples 7 / 7

Rate-Limit Signaling 7 / 7

Typed Event Surface 6 / 6

Agent Skills 5 / 5

Well-Known Catalog 0 / 4

Consent & Bot Identity 0 / 3

A2A Agent Card 0 / 8

Dry-Run / Simulate Mode 0 / 4

Delegated User Identity 0 / 6

Protected Resource Metadata 0 / 5

Registration Without a Human 0 / 6

Agentic Commerce Surface 0 / 5

Improve this rating by publishing the missing artifacts — every area above can be raised, and the full rubric is at apis.io/rating/. Every facet and dimension name above is a link: it opens that measurement's own page — what it means, the exact checks that feed it, how the whole catalog distributes on it, and the providers at the top of it. This rating is computed from github.com/api-evangelist/madeiramadeira: open an issue to ask a question, or submit a pull request to add artifacts. Submit an artifact on GitHub — free → Manage your own listing — the Influence plan, $499/mo →

APIs 7

Individual APIs this provider publishes, each with its own machine-readable definition.

Rate Limits 1

Documented rate limits and quota policies.

Get Started 3

Portal, sign-up, and the first successful call

DeveloperPortal

DeveloperPortal

GettingStarted

GettingStarted

SignUp

SignUp

Documentation 2

Reference material describing how the API behaves

Documentation

Documentation

APIReference

APIReference

Agent Surfaces 2

MCP servers, agent skills, and machine-readable catalogs

AgentSkill

AgentSkill

LLMsTxt

LLMsTxt

Design & Contract 2

Pagination, idempotency, versioning, errors, and events

Lifecycle

Lifecycle

Conformance

Conformance

Build 3

SDKs, sample code, and the tooling you integrate with

Postman

Postman

GitHubOrganization

GitHubOrganization

Packages

Packages

Access & Security 1

Authentication, authorization, and security posture

DomainSecurity

DomainSecurity

Operate 2

Status, limits, changes, and where to get help

Support

Support

Deprecation

Deprecation

Commercial 3

Pricing, plans, and the legal terms of use

TermsOfService

TermsOfService

PrivacyPolicy

PrivacyPolicy

Plans

Plans

Company 2

The organization behind the API

Website

Website

Blog

Blog

Other 2

Properties that don't map to a standard resource type

CapabilityMap

CapabilityMap

Overlay

Overlay

Source (apis.yml)

aid: madeiramadeira
name: Madeiramadeira
description: 'MadeiraMadeira (MadeiraMadeira Comercio Eletronico S/A, Curitiba, Parana) is one of Brazil''s largest online
  retailers and marketplaces for home goods - furniture, decor, appliances, building materials, bathroom and kitchen fixtures,
  and planned furniture - selling direct and through a third-party seller marketplace. Its developer surface is the seller-facing
  Marketplace MadeiraMadeira API: a versioned REST API over HTTPS at marketplace.madeiramadeira.com.br with a matching sandbox
  host, authenticated with a seller-bound TOKENMM header token issued in the Portal Marketplace. It covers product catalog
  submission and enrichment lifecycle, the category tree, price, stock and status updates, shipping (frete) tables plus a
  seller-hosted shipping-quote callback, the full order lifecycle from new through invoiced, shipped and delivered, financial
  ledger entries, and a JWT-authenticated Mensageria surface for buyer-seller messaging, attachments and tracking updates.
  Order and product events are delivered to seller-registered callback URLs.'
url: https://raw.githubusercontent.com/api-evangelist/madeiramadeira/refs/heads/main/apis.yml
deliveryModel:
  model: saas
  open_source: false
  commercial: true
  callable_host: true
  label: Hosted service · you call their endpoint
  confidence: high
  source:
  - openapi
  - pricing
  generated: '2026-08-28'
  method: derived
accessModel:
  pricing: unknown
  onboarding: self-serve
  trial: false
  try_now: false
  public: false
  label: Self-serve signup
  confidence: medium
  source:
  - authentication
  - rate-limits
  - security
  - sandbox
  generated: '2026-09-02'
  method: derived
image: https://kinlane-productions2.s3.amazonaws.com/apis-json/apis-json-logo.jpg
x-type: company
x-source: harvest:secondary-market
specificationVersion: '0.20'
created: '2026-08-25'
modified: '2026-08-25'
tags:
- Company
- E-Commerce
- Marketplace
- Retail
- Home Goods
- Furniture
- Brazil
- Seller Integration
- Product Catalog
- Order
- Shipping
- Logistics
tags_raw:
- Company
- E-Commerce
- Marketplace
- Retail
- Home Goods
- Furniture
- Brazil
- Seller Integration
- Product Catalog
- Orders
- Shipping
- Logistics
apis:
- aid: madeiramadeira:madeiramadeira-callbacks-api
  name: Madeiramadeira Callbacks API
  description: The Callbacks API from Madeiramadeira — 2 operation(s) for callbacks.
  humanURL: https://documenter.getpostman.com/view/3341659/RztmqU19
  baseURL: https://marketplace.madeiramadeira.com.br
  tags:
  - Callbacks
  properties:
  - type: OpenAPI
    url: openapi/madeiramadeira-callbacks-api-openapi.yml
  - type: Postman
    url: https://documenter.getpostman.com/view/3341659/RztmqU19
  - type: Documentation
    url: https://documenter.getpostman.com/view/3341659/RztmqU19
  - type: APIReference
    url: https://documenter.getpostman.com/view/3341659/RztmqU19
  - type: Authentication
    url: authentication/madeiramadeira-authentication.yml
  - type: ErrorCatalog
    url: errors/madeiramadeira-problem-types.yml
  - type: Webhooks
    url: asyncapi/madeiramadeira-marketplace-webhooks.yml
  - type: Conventions
    url: conventions/madeiramadeira-conventions.yml
  - type: RateLimits
    url: rate-limits/madeiramadeira-rate-limits.yml
  - type: Sandbox
    url: sandbox/madeiramadeira-sandbox.yml
  - type: DataModel
    url: data-model/madeiramadeira-data-model.yml
- aid: madeiramadeira:madeiramadeira-categorias-api
  name: Madeiramadeira Categorias API
  description: The Categorias API from Madeiramadeira — 1 operation(s) for categorias.
  humanURL: https://documenter.getpostman.com/view/3341659/RztmqU19
  baseURL: https://marketplace.madeiramadeira.com.br
  tags:
  - Categorias
  properties:
  - type: OpenAPI
    url: openapi/madeiramadeira-categorias-api-openapi.yml
  - type: Postman
    url: https://documenter.getpostman.com/view/3341659/RztmqU19
  - type: Documentation
    url: https://documenter.getpostman.com/view/3341659/RztmqU19
  - type: APIReference
    url: https://documenter.getpostman.com/view/3341659/RztmqU19
  - type: Authentication
    url: authentication/madeiramadeira-authentication.yml
  - type: ErrorCatalog
    url: errors/madeiramadeira-problem-types.yml
  - type: Webhooks
    url: asyncapi/madeiramadeira-marketplace-webhooks.yml
  - type: Conventions
    url: conventions/madeiramadeira-conventions.yml
  - type: RateLimits
    url: rate-limits/madeiramadeira-rate-limits.yml
  - type: Sandbox
    url: sandbox/madeiramadeira-sandbox.yml
  - type: DataModel
    url: data-model/madeiramadeira-data-model.yml
- aid: madeiramadeira:madeiramadeira-financeiro-api
  name: Madeiramadeira Financeiro API
  description: The Financeiro API from Madeiramadeira — 1 operation(s) for financeiro.
  humanURL: https://documenter.getpostman.com/view/3341659/RztmqU19
  baseURL: https://marketplace.madeiramadeira.com.br
  tags:
  - Financeiro
  properties:
  - type: OpenAPI
    url: openapi/madeiramadeira-financeiro-api-openapi.yml
  - type: Postman
    url: https://documenter.getpostman.com/view/3341659/RztmqU19
  - type: Documentation
    url: https://documenter.getpostman.com/view/3341659/RztmqU19
  - type: APIReference
    url: https://documenter.getpostman.com/view/3341659/RztmqU19
  - type: Authentication
    url: authentication/madeiramadeira-authentication.yml
  - type: ErrorCatalog
    url: errors/madeiramadeira-problem-types.yml
  - type: Webhooks
    url: asyncapi/madeiramadeira-marketplace-webhooks.yml
  - type: Conventions
    url: conventions/madeiramadeira-conventions.yml
  - type: RateLimits
    url: rate-limits/madeiramadeira-rate-limits.yml
  - type: Sandbox
    url: sandbox/madeiramadeira-sandbox.yml
  - type: DataModel
    url: data-model/madeiramadeira-data-model.yml
- aid: madeiramadeira:madeiramadeira-frete-api
  name: Madeiramadeira Frete API
  description: The Frete API from Madeiramadeira — 1 operation(s) for frete.
  humanURL: https://documenter.getpostman.com/view/3341659/RztmqU19
  baseURL: https://marketplace.madeiramadeira.com.br
  tags:
  - Frete
  properties:
  - type: OpenAPI
    url: openapi/madeiramadeira-frete-api-openapi.yml
  - type: Postman
    url: https://documenter.getpostman.com/view/3341659/RztmqU19
  - type: Documentation
    url: https://documenter.getpostman.com/view/3341659/RztmqU19
  - type: APIReference
    url: https://documenter.getpostman.com/view/3341659/RztmqU19
  - type: Authentication
    url: authentication/madeiramadeira-authentication.yml
  - type: ErrorCatalog
    url: errors/madeiramadeira-problem-types.yml
  - type: Webhooks
    url: asyncapi/madeiramadeira-marketplace-webhooks.yml
  - type: Conventions
    url: conventions/madeiramadeira-conventions.yml
  - type: RateLimits
    url: rate-limits/madeiramadeira-rate-limits.yml
  - type: Sandbox
    url: sandbox/madeiramadeira-sandbox.yml
  - type: DataModel
    url: data-model/madeiramadeira-data-model.yml
- aid: madeiramadeira:madeiramadeira-mensageria-api
  name: Madeiramadeira Mensageria API
  description: The Mensageria API from Madeiramadeira — 12 operation(s) for mensageria.
  humanURL: https://documenter.getpostman.com/view/3341659/RztmqU19
  baseURL: https://marketplace.madeiramadeira.com.br
  tags:
  - Mensageria
  properties:
  - type: OpenAPI
    url: openapi/madeiramadeira-mensageria-api-openapi.yml
  - type: Postman
    url: https://documenter.getpostman.com/view/3341659/RztmqU19
  - type: Documentation
    url: https://documenter.getpostman.com/view/3341659/RztmqU19
  - type: APIReference
    url: https://documenter.getpostman.com/view/3341659/RztmqU19
  - type: Authentication
    url: authentication/madeiramadeira-authentication.yml
  - type: ErrorCatalog
    url: errors/madeiramadeira-problem-types.yml
  - type: Webhooks
    url: asyncapi/madeiramadeira-marketplace-webhooks.yml
  - type: Conventions
    url: conventions/madeiramadeira-conventions.yml
  - type: RateLimits
    url: rate-limits/madeiramadeira-rate-limits.yml
  - type: Sandbox
    url: sandbox/madeiramadeira-sandbox.yml
  - type: DataModel
    url: data-model/madeiramadeira-data-model.yml
- aid: madeiramadeira:madeiramadeira-pedido-api
  name: Madeiramadeira Pedido API
  description: The Pedido API from Madeiramadeira — 9 operation(s) for pedido.
  humanURL: https://documenter.getpostman.com/view/3341659/RztmqU19
  baseURL: https://marketplace.madeiramadeira.com.br
  tags:
  - Pedido
  properties:
  - type: OpenAPI
    url: openapi/madeiramadeira-pedido-api-openapi.yml
  - type: Postman
    url: https://documenter.getpostman.com/view/3341659/RztmqU19
  - type: Documentation
    url: https://documenter.getpostman.com/view/3341659/RztmqU19
  - type: APIReference
    url: https://documenter.getpostman.com/view/3341659/RztmqU19
  - type: Authentication
    url: authentication/madeiramadeira-authentication.yml
  - type: ErrorCatalog
    url: errors/madeiramadeira-problem-types.yml
  - type: Webhooks
    url: asyncapi/madeiramadeira-marketplace-webhooks.yml
  - type: Conventions
    url: conventions/madeiramadeira-conventions.yml
  - type: RateLimits
    url: rate-limits/madeiramadeira-rate-limits.yml
  - type: Sandbox
    url: sandbox/madeiramadeira-sandbox.yml
  - type: DataModel
    url: data-model/madeiramadeira-data-model.yml
- aid: madeiramadeira:madeiramadeira-produtos-api
  name: Madeiramadeira Produtos API
  description: The Produtos API from Madeiramadeira — 38 operation(s) for produtos.
  humanURL: https://documenter.getpostman.com/view/3341659/RztmqU19
  baseURL: https://marketplace.madeiramadeira.com.br
  tags:
  - Produtos
  properties:
  - type: OpenAPI
    url: openapi/madeiramadeira-produtos-api-openapi.yml
  - type: Postman
    url: https://documenter.getpostman.com/view/3341659/RztmqU19
  - type: Documentation
    url: https://documenter.getpostman.com/view/3341659/RztmqU19
  - type: APIReference
    url: https://documenter.getpostman.com/view/3341659/RztmqU19
  - type: Authentication
    url: authentication/madeiramadeira-authentication.yml
  - type: ErrorCatalog
    url: errors/madeiramadeira-problem-types.yml
  - type: Webhooks
    url: asyncapi/madeiramadeira-marketplace-webhooks.yml
  - type: Conventions
    url: conventions/madeiramadeira-conventions.yml
  - type: RateLimits
    url: rate-limits/madeiramadeira-rate-limits.yml
  - type: Sandbox
    url: sandbox/madeiramadeira-sandbox.yml
  - type: DataModel
    url: data-model/madeiramadeira-data-model.yml
maintainers:
- FN: Kin Lane
  email: kin@apievangelist.com
- FN: APIs.json
  email: info@apis.io
common:
- type: CapabilityMap
  url: capabilities/madeiramadeira-capability-edges.yml
  name: Madeiramadeira Business Capability Map
- type: Overlay
  url: overlays/madeiramadeira-marketplace-overlay.yaml
- type: AgentSkill
  url: skills/_index.yml
- type: Website
  url: https://www.madeiramadeira.com.br/
- type: DeveloperPortal
  url: https://documenter.getpostman.com/view/3341659/RztmqU19
- type: Documentation
  url: https://documenter.getpostman.com/view/3341659/RztmqU19
- type: APIReference
  url: https://documenter.getpostman.com/view/3341659/RztmqU19
- type: Postman
  url: https://documenter.getpostman.com/view/3341659/RztmqU19
- type: GettingStarted
  url: https://www.madeiramadeira.com.br/marketplace
- type: SignUp
  url: https://www.madeiramadeira.com.br/verificar
- type: Support
  url: https://madeiramadeira.zendesk.com/hc/pt-br
- type: Blog
  url: https://parceiros.madeiramadeira.com.br/
- type: GitHubOrganization
  url: https://github.com/madeiramadeirabr
- type: TermsOfService
  url: https://www.madeiramadeira.com.br/termos
- type: PrivacyPolicy
  url: https://www.madeiramadeira.com.br/termos-e-privacidade
- type: Plans
  url: plans/madeiramadeira-plans-pricing.yml
- type: Lifecycle
  url: lifecycle/madeiramadeira-lifecycle.yml
- type: Deprecation
  url: lifecycle/madeiramadeira-lifecycle.yml
- type: Conformance
  url: conformance/madeiramadeira-conformance.yml
- type: DomainSecurity
  url: security/madeiramadeira-domain-security.yml
- type: Packages
  url: packages/madeiramadeira-packages.yml
- type: LLMsTxt
  url: llms/madeiramadeira-llms.txt
x-enrichment:
  date: '2026-08-25'
  status: enriched
  artifacts_added: 24
  pass: local-v1
x-coverage:
  state: covered
  reason: contract-published
  detail: MadeiraMadeira publishes a real first-party machine-readable contract for its seller Marketplace API as a Postman
    collection (69 requests) at documenter.getpostman.com/view/3341659/RztmqU19, retrievable as JSON and served against its
    own hosts marketplace.madeiramadeira.com.br and marketplace-sandbox.madeiramadeira.com.br, both of which answered a live
    unauthenticated probe with HTTP 401 and the documented error envelope.
  evidence:
  - url: https://documenter.gw.postman.com/api/collections/3341659/RztmqU19
    status: 200
  - url: https://marketplace.madeiramadeira.com.br/v1/categoria/limit=1&offset=0
    status: 401
  - url: https://marketplace-sandbox.madeiramadeira.com.br/v1/categoria/limit=1&offset=0
    status: 401
  - url: https://www.madeiramadeira.com.br/marketplace
    status: 200
  checked: '2026-08-25'

Work with this as data

Every provider here is available over the APIs.io API and to AI agents over MCP.

MCP server

One button, every client — Claude, Cursor, VS Code and the rest.

https://apis.io/mcp

Tools for providers

9 MCP tools reach this

find_providersBrowse and filter every provider in the catalog.
get_provider_artifactsEvery artifact this provider publishes, grouped by type.
get_provider_operationsEvery operation across all of their OpenAPIs — one call instead of parsing every spec.
get_provider_toolsEvery MCP tool they ship, with the operation each wraps.
get_provider_evidenceHow each part of their score was established. Free — the basis for a claim should not sit behind it.
get_provider_ratingPRO — composite, band, trend and facet scores.
apis_io_searchSTART HERE — APIs, providers and tags for one query, each with its total.
resolveTurn a domain, URL or GitHub org into the provider it belongs to.
find_cohortsEvery scored population of providers in the catalog.

All 92 tools →

Call it yourself

curl for this page

This provider

curl "https://apis.io/api/v1/providers/madeiramadeira"

All providers

curl "https://apis.io/api/v1/providers?limit=25"

Every operation they expose

curl "https://apis.io/api/v1/providers/madeiramadeira/operations?limit=25"

How their score was established

curl "https://apis.io/api/v1/providers/madeiramadeira/evidence"

Discovery needs no key. Ratings and market analysis are Pro.

Get an API key

Free tier, no email required.

GitHub Google LinkedIn

A second provider on the same verified email joins the account you already have.

Madeiramadeira

What this lets a business do 1

Kin Score

APIs 7

Madeiramadeira Callbacks API

Madeiramadeira Categorias API

Madeiramadeira Financeiro API

Madeiramadeira Frete API

Madeiramadeira Mensageria API

Madeiramadeira Pedido API

Madeiramadeira Produtos API

Pricing Plans 1

Madeiramadeira Plans Pricing