Product

Get flexibility orders

get

Required permissions: Order.Organization.Read Required features: Grid

Query parameters
organizationIdinteger · int32Required

The identifier of the organization.

marketZoneIdinteger · int32Required

The identifier of the market zone.

startstring · date-timeRequired

The start date and time represented using ISO 8601 format and is always in UTC time, e.g. midnight UTC on Jan 1, 2014 would look like this: '2014-01-01T00:00:00Z'.

endstring · date-timeRequired

The end date and time represented using ISO 8601 format and is always in UTC time, e.g. midnight UTC on Jan 1, 2014 would look like this: '2014-01-01T00:00:00Z'.

Responses
200

List of flexibility orders

application/json
get
GET /api/product/order/flexibility HTTP/1.1
Host: qa-api.switchmarket.se
Accept: */*
[
  {
    "id": 1,
    "createdBy": 1,
    "createdAt": "2025-09-16T12:52:32.518Z",
    "expiresAt": "2025-09-16T12:52:32.518Z",
    "start": "2025-09-16T12:52:32.518Z",
    "end": "2025-09-16T12:52:32.518Z",
    "unitPrice": 1,
    "minQuantity": 1,
    "maxQuantity": 1,
    "remainingQuantity": 1,
    "productType": 0,
    "organizationId": 1,
    "resourceId": 1,
    "flexibilityOrderGroupId": 1,
    "availabilityTransactionId": 1,
    "flexibilityScheduleId": 1,
    "availabilityScheduleTransactionId": 1,
    "targetOrganizationIds": [
      1
    ]
  }
]

Get resource availability orders

get

Required permissions: Order.Organization.Read Required features: ResourceManagement

Path parameters
resourceIdinteger · int32Required

The identifier of the resource.

Query parameters
organizationIdinteger · int32Required

The identifier of the organization.

startstring · date-timeRequired

The start date and time represented using ISO 8601 format and is always in UTC time, e.g. midnight UTC on Jan 1, 2014 would look like this: '2014-01-01T00:00:00Z'.

endstring · date-timeRequired

The end date and time represented using ISO 8601 format and is always in UTC time, e.g. midnight UTC on Jan 1, 2014 would look like this: '2014-01-01T00:00:00Z'.

Responses
200

List of availability orders

application/json
get
GET /api/product/order/availability/resource/{resourceId} HTTP/1.1
Host: qa-api.switchmarket.se
Accept: */*
[
  {
    "id": 1,
    "createdAt": "2025-09-16T12:52:32.518Z",
    "expiresAt": "2025-09-16T12:52:32.518Z",
    "flexibilityOrdersExpireAt": "2025-09-16T12:52:32.518Z",
    "start": "2025-09-16T12:52:32.518Z",
    "end": "2025-09-16T12:52:32.518Z",
    "productType": 0,
    "clearingStatus": 0,
    "marketId": 1,
    "organizationId": 1,
    "substationId": 1,
    "resourceId": 1,
    "quantity": 1,
    "availabilityPrice": 1,
    "impact": 1
  }
]

Get resource availability schedule orders

get

Required permissions: Order.Organization.Read Required features: ResourceManagement

Path parameters
resourceIdinteger · int32Required

The identifier of the resource.

Query parameters
organizationIdinteger · int32Required

The identifier of the organization.

Responses
200

List of availability schedule orders

application/json
get
GET /api/product/order/availabilityschedule/resource/{resourceId} HTTP/1.1
Host: qa-api.switchmarket.se
Accept: */*
[
  {
    "id": 1,
    "marketId": 1,
    "organizationId": 1,
    "substationId": 1,
    "resourceId": 1,
    "createdAt": "2025-09-16T12:52:32.518Z",
    "validFrom": "2025-09-16T12:52:32.518Z",
    "validTo": "2025-09-16T12:52:32.518Z",
    "offersAllowedFrom": "2025-09-16T12:52:32.518Z",
    "expiresAt": "2025-09-16T12:52:32.518Z",
    "type": 0,
    "clearingStatus": 0,
    "name": "text",
    "minEndurance": 1,
    "maxEndurance": 1,
    "minCooldown": 1,
    "maxCooldown": 1,
    "timeZone": "text",
    "quantity": 1,
    "totalQuantity": 1,
    "availabilityPrice": 1,
    "impact": 1,
    "templates": [
      {
        "dayOfWeek": 1,
        "hour": 1
      }
    ]
  }
]

Get flexibility transactions

get

Required permissions: Order.Organization.Read Required features: Grid

Query parameters
organizationIdinteger · int32Required

The identifier of the organization.

marketZoneIdinteger · int32Required

The identifier of the market zone.

startstring · date-timeRequired

The start date and time represented using ISO 8601 format and is always in UTC time, e.g. midnight UTC on Jan 1, 2014 would look like this: '2014-01-01T00:00:00Z'.

endstring · date-timeRequired

The end date and time represented using ISO 8601 format and is always in UTC time, e.g. midnight UTC on Jan 1, 2014 would look like this: '2014-01-01T00:00:00Z'.

Responses
200

List of flexibility transactions

application/json
get
GET /api/product/transaction/flexibility HTTP/1.1
Host: qa-api.switchmarket.se
Accept: */*
{
  "flexibilityTransactions": [
    {
      "id": 1,
      "transactionCorrelationId": "123e4567-e89b-12d3-a456-426614174000",
      "availabilityTransactionId": 1,
      "flexibilityScheduleId": 1,
      "availabilityScheduleTransactionId": 1,
      "createdBy": 1,
      "createdAt": "2025-09-16T12:52:32.518Z",
      "organizationId": 1,
      "quantity": 1,
      "marketId": 1,
      "flexibilityOrderId": 1,
      "start": "2025-09-16T12:52:32.518Z",
      "end": "2025-09-16T12:52:32.518Z",
      "resourceId": 1,
      "unitPrice": 1,
      "counterpartOrganizationId": 1,
      "counterpartCreatedBy": 1,
      "productType": 0,
      "deliveryValidationStatus": 0,
      "validatedAt": "2025-09-16T12:52:32.518Z",
      "deliveryPercentage": 1,
      "deliveredQuantity": 1,
      "referenceAdjustmentQuantity": 1,
      "referenceReadingValue": 1,
      "validationReadingValue": 1,
      "remunerationPercentage": 1
    }
  ],
  "otherFlexibilityTransactionsWithImpact": [
    {
      "id": 1,
      "transactionCorrelationId": "123e4567-e89b-12d3-a456-426614174000",
      "availabilityTransactionId": 1,
      "flexibilityScheduleId": 1,
      "availabilityScheduleTransactionId": 1,
      "createdBy": 1,
      "createdAt": "2025-09-16T12:52:32.518Z",
      "organizationId": 1,
      "quantity": 1,
      "marketId": 1,
      "flexibilityOrderId": 1,
      "start": "2025-09-16T12:52:32.518Z",
      "end": "2025-09-16T12:52:32.518Z",
      "resourceId": 1,
      "unitPrice": 1,
      "counterpartOrganizationId": 1,
      "counterpartCreatedBy": 1,
      "productType": 0,
      "deliveryValidationStatus": 0,
      "validatedAt": "2025-09-16T12:52:32.518Z",
      "deliveryPercentage": 1,
      "deliveredQuantity": 1,
      "referenceAdjustmentQuantity": 1,
      "referenceReadingValue": 1,
      "validationReadingValue": 1,
      "remunerationPercentage": 1
    }
  ]
}

Get flexibility transactions affecting substation

get

Required permissions: Order.Organization.Read Required features: DecisionSupport

Path parameters
substationIdinteger · int32Required

The identifier of the substation.

Query parameters
organizationIdinteger · int32Required

The identifier of the organization.

startstring · date-timeRequired

The start date and time represented using ISO 8601 format and is always in UTC time, e.g. midnight UTC on Jan 1, 2014 would look like this: '2014-01-01T00:00:00Z'.

endstring · date-timeRequired

The end date and time represented using ISO 8601 format and is always in UTC time, e.g. midnight UTC on Jan 1, 2014 would look like this: '2014-01-01T00:00:00Z'.

Responses
200

List of flexibility transactions affecting the substation

application/json
get
GET /api/product/transaction/flexibility/affecting/substation/{substationId} HTTP/1.1
Host: qa-api.switchmarket.se
Accept: */*
[
  {
    "flexibilityTransactionId": 1,
    "start": "2025-09-16T12:52:32.518Z",
    "end": "2025-09-16T12:52:32.518Z",
    "quantity": 1,
    "quantityAfterImpact": 1,
    "impact": 1,
    "deliveryValidationStatus": 0,
    "deliveryPercentage": 1,
    "deliveredQuantity": 1,
    "referenceAdjustmentQuantity": 1,
    "referenceReadingValue": 1,
    "validationReadingValue": 1
  }
]

Get availability transactions

get

Required permissions: Order.Organization.Read Required features: Grid

Query parameters
organizationIdinteger · int32Required

The identifier of the organization.

marketZoneIdinteger · int32Required

The identifier of the market zone.

startstring · date-timeRequired

The start date and time represented using ISO 8601 format and is always in UTC time, e.g. midnight UTC on Jan 1, 2014 would look like this: '2014-01-01T00:00:00Z'.

endstring · date-timeRequired

The end date and time represented using ISO 8601 format and is always in UTC time, e.g. midnight UTC on Jan 1, 2014 would look like this: '2014-01-01T00:00:00Z'.

Responses
200

List of availability transactions

application/json
get
GET /api/product/transaction/availability HTTP/1.1
Host: qa-api.switchmarket.se
Accept: */*
[
  {
    "id": 1,
    "createdAt": "2025-09-16T12:52:32.518Z",
    "createdBy": 1,
    "organizationId": 1,
    "resourceId": 1,
    "activationPrice": 1,
    "availabilityPrice": 1,
    "quantity": 1,
    "impactValue": 1,
    "availabilityOrderId": 1,
    "marketId": 1,
    "substationId": 1,
    "counterpartOrganizationId": 1,
    "counterpartCreatedBy": 1,
    "start": "2025-09-16T12:52:32.518Z",
    "end": "2025-09-16T12:52:32.518Z",
    "productType": 0,
    "deliveryValidationStatus": 0,
    "validatedAt": "2025-09-16T12:52:32.518Z",
    "deliveryPercentage": 1,
    "deliveredQuantity": 1,
    "expectedDeliveredQuantity": 1,
    "remunerationPercentage": 1
  }
]

Get availability offers

get

Required permissions: Order.Organization.Read Required features: ResourceManagement

Path parameters
resourceIdinteger · int32Required

The identifier of the resource.

Query parameters
organizationIdinteger · int32Required

The identifier of the organization.

startstring · date-timeRequired

The start date and time represented using ISO 8601 format and is always in UTC time, e.g. midnight UTC on Jan 1, 2014 would look like this: '2014-01-01T00:00:00Z'.

endstring · date-timeRequired

The end date and time represented using ISO 8601 format and is always in UTC time, e.g. midnight UTC on Jan 1, 2014 would look like this: '2014-01-01T00:00:00Z'.

Responses
200

List of availability offers

application/json
get
GET /api/product/offer/availability/resource/{resourceId} HTTP/1.1
Host: qa-api.switchmarket.se
Accept: */*
[
  {
    "createdBy": 1,
    "createdAt": "2025-09-16T12:52:32.518Z",
    "expiresAt": "2025-09-16T12:52:32.518Z",
    "impactValue": 1,
    "activationPrice": 1,
    "maxQuantity": 1,
    "minQuantity": 1,
    "organizationId": 1,
    "resourceId": 1,
    "availabilityOrderId": 1,
    "availabilityTransactionId": 1,
    "clearingStatus": 0
  }
]

Create availability offers

post

Required permissions: Order.Organization.ReadWrite Required features: ResourceManagement

Path parameters
resourceIdinteger · int32Required

The identifier of the resource.

Body
all ofOptional
Responses
200

List of availability offers

application/json
post
POST /api/product/offer/availability/resource/{resourceId} HTTP/1.1
Host: qa-api.switchmarket.se
Content-Type: application/json
Accept: */*
Content-Length: 109

{
  "organizationId": 1,
  "offers": [
    {
      "availabilityOrderId": 1,
      "activationPrice": 1,
      "maxQuantity": 1,
      "minQuantity": 1
    }
  ]
}
[
  {
    "createdBy": 1,
    "createdAt": "2025-09-16T12:52:32.518Z",
    "expiresAt": "2025-09-16T12:52:32.518Z",
    "impactValue": 1,
    "activationPrice": 1,
    "maxQuantity": 1,
    "minQuantity": 1,
    "organizationId": 1,
    "resourceId": 1,
    "availabilityOrderId": 1,
    "availabilityTransactionId": 1,
    "clearingStatus": 0
  }
]

Update availability offers

put

Required permissions: Order.Organization.ReadWrite Required features: ResourceManagement

Path parameters
resourceIdinteger · int32Required

The identifier of the resource.

Body
all ofOptional
Responses
200

List of availability offers

application/json
put
PUT /api/product/offer/availability/resource/{resourceId} HTTP/1.1
Host: qa-api.switchmarket.se
Content-Type: application/json
Accept: */*
Content-Length: 109

{
  "organizationId": 1,
  "offers": [
    {
      "availabilityOrderId": 1,
      "activationPrice": 1,
      "maxQuantity": 1,
      "minQuantity": 1
    }
  ]
}
[
  {
    "createdBy": 1,
    "createdAt": "2025-09-16T12:52:32.518Z",
    "expiresAt": "2025-09-16T12:52:32.518Z",
    "impactValue": 1,
    "activationPrice": 1,
    "maxQuantity": 1,
    "minQuantity": 1,
    "organizationId": 1,
    "resourceId": 1,
    "availabilityOrderId": 1,
    "availabilityTransactionId": 1,
    "clearingStatus": 0
  }
]

Delete availability offers

delete

Required permissions: Order.Organization.ReadWrite Required features: ResourceManagement

Path parameters
resourceIdinteger · int32Required

The identifier of the resource.

Query parameters
organizationIdinteger · int32Required

The identifier of the organization.

availabilityOrderIdinteger · int64[]Required

The identifiers of the availability orders

Responses
204

The availability offers were deleted

No content

delete
DELETE /api/product/offer/availability/resource/{resourceId} HTTP/1.1
Host: qa-api.switchmarket.se
Accept: */*

No content

Get cleared availability offers

get

Required permissions: Order.Organization.Read Required features: DecisionSupport

Query parameters
organizationIdinteger · int32Required

The identifier of the organization.

startstring · date-timeRequired

The start date and time represented using ISO 8601 format and is always in UTC time, e.g. midnight UTC on Jan 1, 2014 would look like this: '2014-01-01T00:00:00Z'.

endstring · date-timeRequired

The end date and time represented using ISO 8601 format and is always in UTC time, e.g. midnight UTC on Jan 1, 2014 would look like this: '2014-01-01T00:00:00Z'.

Responses
200

List of availability offers

application/json
get
GET /api/product/offer/availability/cleared HTTP/1.1
Host: qa-api.switchmarket.se
Accept: */*
[
  {
    "createdBy": 1,
    "createdAt": "2025-09-16T12:52:32.518Z",
    "expiresAt": "2025-09-16T12:52:32.518Z",
    "impactValue": 1,
    "activationPrice": 1,
    "maxQuantity": 1,
    "minQuantity": 1,
    "organizationId": 1,
    "resourceId": 1,
    "availabilityOrderId": 1,
    "availabilityTransactionId": 1,
    "clearingStatus": 0
  }
]

Get cleared availability schedule offers

get

Required permissions: Order.Organization.Read Required features: DecisionSupport

Query parameters
organizationIdinteger · int32Required

The identifier of the organization.

Responses
200

List of availability schedule offers

application/json
get
GET /api/product/offer/availabilityschedule/cleared HTTP/1.1
Host: qa-api.switchmarket.se
Accept: */*
[
  {
    "resourceId": 1,
    "organizationId": 1,
    "availabilityScheduleOrderId": 1,
    "availabilityScheduleTransactionId": 1,
    "createdBy": 1,
    "createdAt": "2025-09-16T12:52:32.518Z",
    "expiresAt": "2025-09-16T12:52:32.518Z",
    "impactValue": 1,
    "activationPrice": 1,
    "maxQuantity": 1,
    "minQuantity": 1,
    "endurance": 1,
    "cooldown": 1
  }
]

Get settlement specification

get

Required permissions: Order.Organization.Read Required features: Settlements

Query parameters
organizationIdinteger · int32Required

The identifier of the organization.

startstring · date-timeRequired

The start date and time represented using ISO 8601 format and is always in UTC time, e.g. midnight UTC on Jan 1, 2014 would look like this: '2014-01-01T00:00:00Z'.

endstring · date-timeRequired

The end date and time represented using ISO 8601 format and is always in UTC time, e.g. midnight UTC on Jan 1, 2014 would look like this: '2014-01-01T00:00:00Z'.

Responses
200

The settlement specification

application/json
get
GET /api/product/settlement/specification HTTP/1.1
Host: qa-api.switchmarket.se
Accept: */*
{
  "organizationId": 1,
  "counterParts": [
    {
      "organizationId": 1,
      "flexibilitySoldSummary": {
        "totalRemunerationSum": 1,
        "transactions": [
          {
            "flexibilityTransactionId": 1,
            "resourceId": 1,
            "deliveryPercentage": 1,
            "remunerationPercentage": 1,
            "unitPrice": 1,
            "totalRemuneration": 1,
            "totalQuantity": 1,
            "productType": 0,
            "deliveryValidationStatus": 0
          }
        ]
      },
      "flexibilityBoughtSummary": {
        "totalRemunerationSum": 1,
        "transactions": [
          {
            "flexibilityTransactionId": 1,
            "resourceId": 1,
            "deliveryPercentage": 1,
            "remunerationPercentage": 1,
            "unitPrice": 1,
            "totalRemuneration": 1,
            "totalQuantity": 1,
            "productType": 0,
            "deliveryValidationStatus": 0
          }
        ]
      },
      "availabilitySoldSummary": {
        "totalRemunerationSum": 1,
        "transactions": [
          {
            "availabilityTransactionId": 1,
            "resourceId": 1,
            "substationId": 1,
            "deliveryPercentage": 1,
            "remunerationPercentage": 1,
            "availabilityPrice": 1,
            "totalRemuneration": 1,
            "totalQuantity": 1,
            "productType": 0,
            "deliveryValidationStatus": 0
          }
        ]
      },
      "availabilityBoughtSummary": {
        "totalRemunerationSum": 1,
        "transactions": [
          {
            "availabilityTransactionId": 1,
            "resourceId": 1,
            "substationId": 1,
            "deliveryPercentage": 1,
            "remunerationPercentage": 1,
            "availabilityPrice": 1,
            "totalRemuneration": 1,
            "totalQuantity": 1,
            "productType": 0,
            "deliveryValidationStatus": 0
          }
        ]
      }
    }
  ],
  "remunerationPerResource": [
    {
      "resourceId": 1,
      "bought": {
        "totalAvailabilityRemunerationSum": 1,
        "totalFlexibilityRemunerationSum": 1
      },
      "sold": {
        "totalAvailabilityRemunerationSum": 1,
        "totalFlexibilityRemunerationSum": 1
      }
    }
  ]
}

Was this helpful?