Switch Developer Documentation
  • Welcome
  • ⚠️Migration to Auth0
    • Overview
    • Status
    • Switch API
      • Client Credentials Flow
      • Organization Client
      • Token Endpoint
    • OpenADR 3 VTN API
      • VTN Credentials
      • Token Endpoint
  • Getting Started
    • Concepts
    • Guides
      • How to send readings
      • Market operations
      • Conditional agreements
    • Support
  • Switch API
    • Overview
    • Terms of Use
    • Authentication
      • Client Credentials Flow
      • Organization Client
      • Token Endpoint
    • Rate Limiting
    • Errors
    • API Reference
      • Market Zones
      • Products
      • Resources
      • Meters
      • Readings
  • OpenADR 3
    • Overview
    • Authentication
      • VTN Credentials
      • Token Endpoint
    • API Reference
      • Programs
      • Events
      • Reports
      • Subscriptions
      • Vens
    • Webhooks
      • Callback URL verification
      • Domain and IP addresses
      • Best practices
    • Payloads
    • Code samples
  • Libraries
    • .NET SDK
      • SDK Reference
        • IAuthService.Auth
        • IProgramsService.Programs
        • IEventsService.Events
        • IReportsService.Reports
        • ISubscriptionsService.Subscriptions
        • IVensService.Vens
Powered by GitBook
On this page

Was this helpful?

  1. Switch API
  2. API Reference

Resources

PreviousProductsNextMeters

Last updated 7 months ago

Was this helpful?

  • GETGet resources
  • POSTSave resource reference readings

Get resources

get

Required permissions: Resource.Organization.ReadRequired features: Grid

Authorizations
Query parameters
organizationIdinteger · int32Required

The identifier of the organization.

marketZoneIdinteger · int32Optional

The identifier of the market zone

Responses
200
List of resources
application/json
400
Input data was invalid
application/json
401
Not authorized
application/json
403
Not allowed
application/json
500
Internal server error
get
GET /api/grid/resource HTTP/1.1
Host: api.switchmarket.se
Authorization: Bearer YOUR_OAUTH2_TOKEN
Accept: */*
[
  {
    "id": 1,
    "organizationId": 1,
    "marketZoneId": 1,
    "concessionAreaId": 1,
    "createdAt": "2025-06-13T10:13:21.196Z",
    "createdBy": 1,
    "connectedAt": "2025-06-13T10:13:21.196Z",
    "name": "text",
    "longitude": "text",
    "latitude": "text",
    "contactInformation": "text",
    "type": 0,
    "regulationType": 0,
    "maxQuantity": 1,
    "endurance": 1,
    "cooldown": 1,
    "useZeroReference": true,
    "actualRegisterId": 1,
    "referenceRegisterId": 1,
    "conditionalDeliveryLimit": 1,
    "conditionalUseDynamicDeliveryLimit": true,
    "conditionalAutomaticAcknowledgement": true,
    "allowedProducts": [
      0
    ],
    "pods": [
      {
        "podId": "text",
        "name": "text",
        "description": "text"
      }
    ]
  }
]

Save resource reference readings

post

Required permissions: Planning.Organization.ReadWriteRequired features: Grid

Authorizations
Path parameters
resourceIdinteger · int32Required

The identifier of the resource.

Body
all ofOptional
Responses
204
Readings were saved
400
Input data was invalid
application/json
401
Not authorized
application/json
403
Not allowed
application/json
500
Internal server error
post
POST /api/grid/resource/{resourceId}/readings/reference HTTP/1.1
Host: api.switchmarket.se
Authorization: Bearer YOUR_OAUTH2_TOKEN
Content-Type: application/json
Accept: */*
Content-Length: 99

{
  "organizationId": 1,
  "readings": [
    {
      "timestamp": "2025-06-13T10:13:21.196Z",
      "value": 1,
      "resolution": 1
    }
  ]
}

No content