Stores

Retrieve a connected store

Retrieve a connected store by its id (UUID v7). Returns the provider connection it hangs from, the identifier the provider gave the shop and its full invoicing configuration. Returns 404 if the store does not exist or belongs to another company — the two answers are identical on purpose, so the endpoint never reveals whether a store of another company exists.

get/companies/{company}/stores/{store}

Request

  • Base URL: https://api.factuarea.com/v1
  • URL: https://api.factuarea.com/v1/companies/{company}/stores/{store}
  • Auth: one of:
    • HTTP bearer
    • API key in header X-API-Key

Path parameters

companystring uuid required

Public identifier (UUID v7) of the company. Get it from GET /v1/me (data.scope[].id).

storestring uuid required

Public identifier (UUID v7) of the connected online store.

Headers

Factuarea-Versionstring date
Example:2026-06-01

Pin the API version (YYYY-MM-DD, Stripe-style date versioning) for this request; omit to use the key's pinned version, or the latest if none. Unsupported version → 400 unsupported_api_version; malformed → 400 parameter_invalid_format. The effective version is echoed in the Factuarea-Version response header. See the Versioning guide.

Response

Example response

{
  "data": {
    "id": "0192e7c2-4d5e-7f3b-a012-3c4d5e6f7090",
    "object": "store",
    "integration_id": "0192e7b1-3c4d-7e2a-9f01-2b3c4d5e6f71",
    "provider": "woocommerce",
    "external_store_id": "wc-tienda-es",
    "name": "Tienda ES",
    "simplified_threshold": "400.00",
    "prices_include_tax": true,
    "remote_base_url": "https://tienda.example.com",
    "environment": "test",
    "status": "active",
    "connected_at": "2026-08-29T09:00:00+00:00",
    "invoice_note": "Pedido pagado en la tienda online. Gracias por su compra."
  }
}

Changes

No recorded changes to this operation across all 1 revision of this API.