SOA

SOA

List SOAs

get

https://api.flowretail.com/v2https://api.stage.flowretail.com/v2

/tenants/{tenantUid}/soas

List all SOAs.

Authorizations

accessTokenauthTokenintegrationToken

Path parameters

tenantUidstringRequired

Reference to a tenant.

Pattern: ^[A-Za-z0-9-_]+

Query parameters

namestringOptional

Reference to the name of a SOA.

externalIdstringOptional

External reference to a SOA.

pageNumberintegerOptional

Reference to a specific page in a result set.

pageSizeintegerOptional

The number of items per page in a result set.

sortBystringOptional

Defines which field the resource list is sorted by.

sortDirectionstring · enumOptional

ENUM	Description
ASC	Sort in ascending order
DESC	Sort in descending order

Possible values:

Responses

200

Example response

application/json

get

/tenants/{tenantUid}/soas

HTTPcURLJavaScriptPython

GET /v2/tenants/{tenantUid}/soas HTTP/1.1
Host: api.flowretail.com
Authorization: Bearer YOUR_SECRET_TOKEN
Accept: */*

200

Example response

{
  "items": [
    {
      "name": "text",
      "externalId": "text",
      "soaUid": "text",
      "createdAt": "2025-10-30T20:45:04.441Z",
      "createdBy": "text",
      "lastModifiedAt": "2025-10-30T20:45:04.441Z",
      "lastModifiedBy": "text"
    }
  ],
  "paging": {
    "pageNumber": 1,
    "pageSize": 1,
    "totalCount": 1
  }
}

Create a new SOA

post

https://api.flowretail.com/v2https://api.stage.flowretail.com/v2

/tenants/{tenantUid}/soas

Create a new SOA.

Authorizations

accessTokenauthTokenintegrationToken

Path parameters

tenantUidstringRequired

Reference to a tenant.

Pattern: ^[A-Za-z0-9-_]+

Body

application/json

all ofOptional

and

Responses

201

Example response

application/json

post

/tenants/{tenantUid}/soas

HTTPcURLJavaScriptPython

POST /v2/tenants/{tenantUid}/soas HTTP/1.1
Host: api.flowretail.com
Authorization: Bearer YOUR_SECRET_TOKEN
Content-Type: application/json
Accept: */*
Content-Length: 51

{
  "externalId": "text",
  "name": "text",
  "soaUid": "text"
}

201

Example response

{
  "name": "text",
  "externalId": "text",
  "soaUid": "text",
  "createdAt": "2025-10-30T20:45:04.441Z",
  "createdBy": "text",
  "lastModifiedAt": "2025-10-30T20:45:04.441Z",
  "lastModifiedBy": "text"
}

BATCH Create SOA amounts

post

https://api.flowretail.com/v2https://api.stage.flowretail.com/v2

/tenants/{tenantUid}/soas/batch

Creates amounts on a SOA.

Items in:

• create : will be created.

• update : will be updated.

• delete: will be deleted.

• upsert: will create or update if needed.

The response http status is either:

• 200: all items in request was processed successfully,

• 207: one or more item was processed with an error.

Authorizations

accessTokenauthTokenintegrationToken

Path parameters

tenantUidstringRequired

Reference to a tenant.

Pattern: ^[A-Za-z0-9-_]+

Body

application/json

upsertall of[]Required

and

Responses

200

Response for SOAAmountBatchRequest. 200: All items in request was processed with no errors 207: One or more items in request returned an error

application/json

207

Response for SOAAmountBatchRequest. 200: All items in request was processed with no errors 207: One or more items in request returned an error

application/json

post

/tenants/{tenantUid}/soas/batch

HTTPcURLJavaScriptPython

POST /v2/tenants/{tenantUid}/soas/batch HTTP/1.1
Host: api.flowretail.com
Authorization: Bearer YOUR_SECRET_TOKEN
Content-Type: application/json
Accept: */*
Content-Length: 183

{
  "upsert": [
    {
      "storeUid": "text",
      "productUid": "text",
      "amount": 1,
      "fromDateTime": "2025-10-30T20:45:04.441Z",
      "toDateTime": "2025-10-30T20:45:04.441Z",
      "soaAmountUid": "text",
      "soaUid": "text"
    }
  ]
}

{
  "upsert": {
    "errors": [
      {
        "errorCode": "text",
        "message": "text",
        "productUid": "text",
        "storeUid": "text",
        "soaUid": "text",
        "soaAmountUid": "text"
      }
    ],
    "success": 1
  }
}

Get SOA details

get

https://api.flowretail.com/v2https://api.stage.flowretail.com/v2

/tenants/{tenantUid}/soas/{soaUid}

Get SOA details.

Authorizations

accessTokenauthTokenintegrationToken

Path parameters

tenantUidstringRequired

Reference to a tenant.

Pattern: ^[A-Za-z0-9-_]+

soaUidstringRequired

Reference to a SOA.

Pattern: ^[A-Za-z0-9-_]+

Responses

200

Example response

application/json

get

/tenants/{tenantUid}/soas/{soaUid}

HTTPcURLJavaScriptPython

GET /v2/tenants/{tenantUid}/soas/{soaUid} HTTP/1.1
Host: api.flowretail.com
Authorization: Bearer YOUR_SECRET_TOKEN
Accept: */*

200

Example response

{
  "name": "text",
  "externalId": "text",
  "soaUid": "text",
  "createdAt": "2025-10-30T20:45:04.441Z",
  "createdBy": "text",
  "lastModifiedAt": "2025-10-30T20:45:04.441Z",
  "lastModifiedBy": "text"
}

Update SOA details

put

https://api.flowretail.com/v2https://api.stage.flowretail.com/v2

/tenants/{tenantUid}/soas/{soaUid}

Update SO details.

Authorizations

accessTokenauthTokenintegrationToken

Path parameters

tenantUidstringRequired

Reference to a tenant.

Pattern: ^[A-Za-z0-9-_]+

soaUidstringRequired

Reference to a SOA.

Pattern: ^[A-Za-z0-9-_]+

Body

application/json

externalIdstringOptional

namestringOptional

Responses

200

Example response

application/json

put

/tenants/{tenantUid}/soas/{soaUid}

HTTPcURLJavaScriptPython

PUT /v2/tenants/{tenantUid}/soas/{soaUid} HTTP/1.1
Host: api.flowretail.com
Authorization: Bearer YOUR_SECRET_TOKEN
Content-Type: application/json
Accept: */*
Content-Length: 35

{
  "externalId": "text",
  "name": "text"
}

200

Example response

{
  "name": "text",
  "externalId": "text",
  "soaUid": "text",
  "createdAt": "2025-10-30T20:45:04.441Z",
  "createdBy": "text",
  "lastModifiedAt": "2025-10-30T20:45:04.441Z",
  "lastModifiedBy": "text"
}

Delete a SOA

delete

https://api.flowretail.com/v2https://api.stage.flowretail.com/v2

/tenants/{tenantUid}/soas/{soaUid}

Deletes a SOA and all associated amounts.

Authorizations

accessTokenauthTokenintegrationToken

Path parameters

tenantUidstringRequired

Reference to a tenant.

Pattern: ^[A-Za-z0-9-_]+

soaUidstringRequired

Reference to a SOA.

Pattern: ^[A-Za-z0-9-_]+

Responses

204

No Content

No content

delete

/tenants/{tenantUid}/soas/{soaUid}

HTTPcURLJavaScriptPython

DELETE /v2/tenants/{tenantUid}/soas/{soaUid} HTTP/1.1
Host: api.flowretail.com
Authorization: Bearer YOUR_SECRET_TOKEN
Accept: */*

204

No Content

No content

List SOA Amounts associated with a SOA

get

https://api.flowretail.com/v2https://api.stage.flowretail.com/v2

/tenants/{tenantUid}/soas/{soaUid}/amounts

List SOA Amounts associated with a SOA

Authorizations

accessTokenauthTokenintegrationToken

Path parameters

tenantUidstringRequired

Reference to a tenant.

Pattern: ^[A-Za-z0-9-_]+

soaUidstringRequired

Reference to a SOA.

Pattern: ^[A-Za-z0-9-_]+

Query parameters

pageNumberintegerOptional

Reference to a specific page in a result set.

pageSizeintegerOptional

The number of items per page in a result set.

sortBystringOptional

Defines which field the resource list is sorted by.

sortDirectionstring · enumOptional

ENUM	Description
ASC	Sort in ascending order
DESC	Sort in descending order

Possible values:

Responses

2XX

List of SOA Amounts

application/json

get

/tenants/{tenantUid}/soas/{soaUid}/amounts

HTTPcURLJavaScriptPython

GET /v2/tenants/{tenantUid}/soas/{soaUid}/amounts HTTP/1.1
Host: api.flowretail.com
Authorization: Bearer YOUR_SECRET_TOKEN
Accept: */*

2XX

List of SOA Amounts

{
  "items": [
    {
      "soaUid": "text",
      "storeUid": "text",
      "productUid": "text",
      "soaAmountUid": "text",
      "amount": 1,
      "fromDateTime": "2025-10-30T20:45:04.441Z",
      "toDateTime": "2025-10-30T20:45:04.441Z",
      "createdAt": "2025-10-30T20:45:04.441Z",
      "createdBy": "text",
      "lastModifiedAt": "2025-10-30T20:45:04.441Z",
      "lastModifiedBy": "text"
    }
  ],
  "paging": {
    "pageNumber": 1,
    "pageSize": 1,
    "totalCount": 1
  }
}

Create a SOA amount

post

https://api.flowretail.com/v2https://api.stage.flowretail.com/v2

/tenants/{tenantUid}/soas/{soaUid}/amounts

Create a SOA amount.

Authorizations

accessTokenauthTokenintegrationToken

Path parameters

tenantUidstringRequired

Reference to a tenant.

Pattern: ^[A-Za-z0-9-_]+

soaUidstringRequired

Reference to a SOA.

Pattern: ^[A-Za-z0-9-_]+

Body

application/json

storeUidstringRequiredPattern: ^[A-Za-z0-9-_]+

productUidstringRequiredPattern: ^[A-Za-z0-9-_]+

amountintegerRequired

fromDateTimestring · date-timeRequired

toDateTimestring · date-timeRequired

soaAmountUidstringOptionalPattern: ^[A-Za-z0-9-_]+

Responses

201

Example response

application/json

post

/tenants/{tenantUid}/soas/{soaUid}/amounts

HTTPcURLJavaScriptPython

POST /v2/tenants/{tenantUid}/soas/{soaUid}/amounts HTTP/1.1
Host: api.flowretail.com
Authorization: Bearer YOUR_SECRET_TOKEN
Content-Type: application/json
Accept: */*
Content-Length: 154

{
  "storeUid": "text",
  "productUid": "text",
  "amount": 1,
  "fromDateTime": "2025-10-30T20:45:04.441Z",
  "toDateTime": "2025-10-30T20:45:04.441Z",
  "soaAmountUid": "text"
}

201

Example response

{
  "soaUid": "text",
  "storeUid": "text",
  "productUid": "text",
  "soaAmountUid": "text",
  "amount": 1,
  "fromDateTime": "2025-10-30T20:45:04.441Z",
  "toDateTime": "2025-10-30T20:45:04.441Z",
  "createdAt": "2025-10-30T20:45:04.441Z",
  "createdBy": "text",
  "lastModifiedAt": "2025-10-30T20:45:04.441Z",
  "lastModifiedBy": "text"
}

Get a SOA amount

get

https://api.flowretail.com/v2https://api.stage.flowretail.com/v2

/tenants/{tenantUid}/soas/{soaUid}/amounts/{soaAmountUid}

Get a SOA amount.

Authorizations

accessTokenauthTokenintegrationToken

Path parameters

tenantUidstringRequired

Reference to a tenant.

Pattern: ^[A-Za-z0-9-_]+

soaUidstringRequired

Reference to a SOA.

Pattern: ^[A-Za-z0-9-_]+

soaAmountUidstringRequired

Reference to a SOA amount.

Pattern: ^[A-Za-z0-9-_]+

Responses

200

Example response

application/json

get

/tenants/{tenantUid}/soas/{soaUid}/amounts/{soaAmountUid}

HTTPcURLJavaScriptPython

GET /v2/tenants/{tenantUid}/soas/{soaUid}/amounts/{soaAmountUid} HTTP/1.1
Host: api.flowretail.com
Authorization: Bearer YOUR_SECRET_TOKEN
Accept: */*

200

Example response

{
  "soaUid": "text",
  "storeUid": "text",
  "productUid": "text",
  "soaAmountUid": "text",
  "amount": 1,
  "fromDateTime": "2025-10-30T20:45:04.441Z",
  "toDateTime": "2025-10-30T20:45:04.441Z",
  "createdAt": "2025-10-30T20:45:04.441Z",
  "createdBy": "text",
  "lastModifiedAt": "2025-10-30T20:45:04.441Z",
  "lastModifiedBy": "text"
}

Update SOA amount details

put

https://api.flowretail.com/v2https://api.stage.flowretail.com/v2

/tenants/{tenantUid}/soas/{soaUid}/amounts/{soaAmountUid}

Update SOA amount details

Authorizations

accessTokenauthTokenintegrationToken

Path parameters

tenantUidstringRequired

Reference to a tenant.

Pattern: ^[A-Za-z0-9-_]+

soaUidstringRequired

Reference to a SOA.

Pattern: ^[A-Za-z0-9-_]+

soaAmountUidstringRequired

Reference to a SOA amount.

Pattern: ^[A-Za-z0-9-_]+

Body

application/json

storeUidstringOptionalPattern: ^[A-Za-z0-9-_]+

productUidstringOptionalPattern: ^[A-Za-z0-9-_]+

amountintegerOptional

fromDateTimestring · date-timeOptional

toDateTimestring · date-timeOptional

Responses

200

Example response

application/json

put

/tenants/{tenantUid}/soas/{soaUid}/amounts/{soaAmountUid}

HTTPcURLJavaScriptPython

PUT /v2/tenants/{tenantUid}/soas/{soaUid}/amounts/{soaAmountUid} HTTP/1.1
Host: api.flowretail.com
Authorization: Bearer YOUR_SECRET_TOKEN
Content-Type: application/json
Accept: */*
Content-Length: 132

{
  "storeUid": "text",
  "productUid": "text",
  "amount": 1,
  "fromDateTime": "2025-10-30T20:45:04.441Z",
  "toDateTime": "2025-10-30T20:45:04.441Z"
}

200

Example response

{
  "soaUid": "text",
  "storeUid": "text",
  "productUid": "text",
  "soaAmountUid": "text",
  "amount": 1,
  "fromDateTime": "2025-10-30T20:45:04.441Z",
  "toDateTime": "2025-10-30T20:45:04.441Z",
  "createdAt": "2025-10-30T20:45:04.441Z",
  "createdBy": "text",
  "lastModifiedAt": "2025-10-30T20:45:04.441Z",
  "lastModifiedBy": "text"
}

Delete a SOA amount

delete

https://api.flowretail.com/v2https://api.stage.flowretail.com/v2

/tenants/{tenantUid}/soas/{soaUid}/amounts/{soaAmountUid}

Delete a SOA amount

Authorizations

accessTokenauthTokenintegrationToken

Path parameters

tenantUidstringRequired

Reference to a tenant.

Pattern: ^[A-Za-z0-9-_]+

soaUidstringRequired

Reference to a SOA.

Pattern: ^[A-Za-z0-9-_]+

soaAmountUidstringRequired

Reference to a SOA amount.

Pattern: ^[A-Za-z0-9-_]+

Responses

204

No Content

No content

delete

/tenants/{tenantUid}/soas/{soaUid}/amounts/{soaAmountUid}

HTTPcURLJavaScriptPython

DELETE /v2/tenants/{tenantUid}/soas/{soaUid}/amounts/{soaAmountUid} HTTP/1.1
Host: api.flowretail.com
Authorization: Bearer YOUR_SECRET_TOKEN
Accept: */*

204

No Content

No content