Get store

GET https://api.fire.rest/api/v1/fire/external/stores/550e8400-e29b-41d4-a716-446655440000
x-api-key: <your_api_key>

{
  "id": "550e8400-e29b-41d4-a716-446655440000",
  "storeNumber": 10,
  "storeCode": "ST-10",
  "accountId": "550e8400-e29b-41d4-a716-446655440000",
  "vendorId": "100.1.10",
  "name": "Main Store",
  "externalId": "EXT-10",
  "status": "PUBLISHED",
  "active": "ACTIVE",
  "timezone": "America/Guayaquil",
  "location": {
    "countryId": "1",
    "countryCode": "EC",
    "countryName": "Ecuador",
    "cityId": "2",
    "cityCode": "UIO",
    "cityName": "Quito",
    "address": "Av. Amazonas N32-14",
    "latitude": -0.18,
    "longitude": -78.47,
    "timezone": "America/Guayaquil",
    "currencyCode": "USD"
  },
  "services": [],
  "channels": [
    { "code": "APP", "enabled": true, "fulfillmentTypes": ["DELIVERY", "PICKUP"] }
  ],
  "publishedChannels": ["APP"],
  "operationSchedule": [],
  "salesSchedule": [],
  "schedulesByChannel": [],
  "taxesInfo": { "taxRate": 0, "vatRatePercentage": 12 },
  "contactInfo": { "phone": "+593 2 000 0000" },
  "deliveryInfo": null,
  "salesGoals": null,
  "fiscal": {
    "enabled": true,
    "company": {
      "govIdType": "RUC",
      "govIdNumber": "1790012345001",
      "legalName": "Sandbox Ecuador Cia. Ltda.",
      "tradeName": "Sandbox EC"
    },
    "govIdType": "RUC",
    "govIdNumber": "1790012345001"
  },
  "operational": {
    "isBusinessDayOpen": true,
    "businessDayDate": "2026-07-01",
    "activeChannels": ["APP"]
  },
  "syncStatus": "SYNCED",
  "lastSyncedAt": "2026-07-01T00:00:00Z",
  "createdAt": "2026-06-01T00:00:00Z",
  "updatedAt": "2026-06-02T00:00:00Z"
}

{
  "success": false,
  "error": "NOT_FOUND",
  "message": "Store not found with ID 550e8400-e29b-41d4-a716-446655440000"
}

GET

api

fire

external

stores

{storeId}

GET https://api.fire.rest/api/v1/fire/external/stores/550e8400-e29b-41d4-a716-446655440000
x-api-key: <your_api_key>

{
  "id": "550e8400-e29b-41d4-a716-446655440000",
  "storeNumber": 10,
  "storeCode": "ST-10",
  "accountId": "550e8400-e29b-41d4-a716-446655440000",
  "vendorId": "100.1.10",
  "name": "Main Store",
  "externalId": "EXT-10",
  "status": "PUBLISHED",
  "active": "ACTIVE",
  "timezone": "America/Guayaquil",
  "location": {
    "countryId": "1",
    "countryCode": "EC",
    "countryName": "Ecuador",
    "cityId": "2",
    "cityCode": "UIO",
    "cityName": "Quito",
    "address": "Av. Amazonas N32-14",
    "latitude": -0.18,
    "longitude": -78.47,
    "timezone": "America/Guayaquil",
    "currencyCode": "USD"
  },
  "services": [],
  "channels": [
    { "code": "APP", "enabled": true, "fulfillmentTypes": ["DELIVERY", "PICKUP"] }
  ],
  "publishedChannels": ["APP"],
  "operationSchedule": [],
  "salesSchedule": [],
  "schedulesByChannel": [],
  "taxesInfo": { "taxRate": 0, "vatRatePercentage": 12 },
  "contactInfo": { "phone": "+593 2 000 0000" },
  "deliveryInfo": null,
  "salesGoals": null,
  "fiscal": {
    "enabled": true,
    "company": {
      "govIdType": "RUC",
      "govIdNumber": "1790012345001",
      "legalName": "Sandbox Ecuador Cia. Ltda.",
      "tradeName": "Sandbox EC"
    },
    "govIdType": "RUC",
    "govIdNumber": "1790012345001"
  },
  "operational": {
    "isBusinessDayOpen": true,
    "businessDayDate": "2026-07-01",
    "activeChannels": ["APP"]
  },
  "syncStatus": "SYNCED",
  "lastSyncedAt": "2026-07-01T00:00:00Z",
  "createdAt": "2026-06-01T00:00:00Z",
  "updatedAt": "2026-06-02T00:00:00Z"
}

{
  "success": false,
  "error": "NOT_FOUND",
  "message": "Store not found with ID 550e8400-e29b-41d4-a716-446655440000"
}

Returns a single store by its id, with the full configuration — the same shape as each entry in List stores (location, services, channels, schedules, tax & contact info, delivery config, sales goals, the fiscal block, and operational state). If the store does not exist — or belongs to another tenant — the response is 404 (existence is never leaked across tenants).

Authentication

string

required

Your Fire API key with the store:read scope. The key must be vendor-scoped — keys without a vendorId are rejected with 403.

Path parameters

string

required

Store UUID (stores.id).

Query parameters

string

Comma-separated list of fields to return (projection). See Field projection. Omit to return every field.

Request

GET https://api.fire.rest/api/v1/fire/external/stores/550e8400-e29b-41d4-a716-446655440000
x-api-key: <your_api_key>

Response

The full store object — see List stores for the complete field reference and the fiscal block.

{
  "id": "550e8400-e29b-41d4-a716-446655440000",
  "storeNumber": 10,
  "storeCode": "ST-10",
  "accountId": "550e8400-e29b-41d4-a716-446655440000",
  "vendorId": "100.1.10",
  "name": "Main Store",
  "externalId": "EXT-10",
  "status": "PUBLISHED",
  "active": "ACTIVE",
  "timezone": "America/Guayaquil",
  "location": {
    "countryId": "1",
    "countryCode": "EC",
    "countryName": "Ecuador",
    "cityId": "2",
    "cityCode": "UIO",
    "cityName": "Quito",
    "address": "Av. Amazonas N32-14",
    "latitude": -0.18,
    "longitude": -78.47,
    "timezone": "America/Guayaquil",
    "currencyCode": "USD"
  },
  "services": [],
  "channels": [
    { "code": "APP", "enabled": true, "fulfillmentTypes": ["DELIVERY", "PICKUP"] }
  ],
  "publishedChannels": ["APP"],
  "operationSchedule": [],
  "salesSchedule": [],
  "schedulesByChannel": [],
  "taxesInfo": { "taxRate": 0, "vatRatePercentage": 12 },
  "contactInfo": { "phone": "+593 2 000 0000" },
  "deliveryInfo": null,
  "salesGoals": null,
  "fiscal": {
    "enabled": true,
    "company": {
      "govIdType": "RUC",
      "govIdNumber": "1790012345001",
      "legalName": "Sandbox Ecuador Cia. Ltda.",
      "tradeName": "Sandbox EC"
    },
    "govIdType": "RUC",
    "govIdNumber": "1790012345001"
  },
  "operational": {
    "isBusinessDayOpen": true,
    "businessDayDate": "2026-07-01",
    "activeChannels": ["APP"]
  },
  "syncStatus": "SYNCED",
  "lastSyncedAt": "2026-07-01T00:00:00Z",
  "createdAt": "2026-06-01T00:00:00Z",
  "updatedAt": "2026-06-02T00:00:00Z"
}

{
  "success": false,
  "error": "NOT_FOUND",
  "message": "Store not found with ID 550e8400-e29b-41d4-a716-446655440000"
}

List stores

List all stores of your account and vendor.

List store orders

List the orders of this store.

API

Partner APIs

PayBridge

Authentication

Path parameters

Query parameters

Request

Response

List stores

List store orders

​Authentication

​Path parameters

​Query parameters

​Request

​Response

​Related

List stores

List store orders

Authentication

Path parameters

Query parameters

Request

Response

Related