> ## Documentation Index
> Fetch the complete documentation index at: https://docs.engrate.io/llms.txt
> Use this file to discover all available pages before exploring further.

# Send Status Request

> Send a status request to TSO.

Queries the current status of schedule applications for a specific delivery date. The TSO responds with an ACK or CNF containing the current status.

Rate limited to 1 request per 15 minutes per balance group per delivery day.

Args:     request: Status request parameters (sender_id, receiver_id, date)     org_uid: Organization UID from request headers     service: Status request service

Returns:     StatusRequestResponse with message_id and status

Raises:     429: Rate limit exceeded (max 1 per 15 min)     400: Invalid request parameters     502: TSO communication error



## OpenAPI

````yaml /openapi.json post /schedule-management/v1/send_status_request
openapi: 3.1.0
info:
  title: Engrate API
  version: 1.0.0
servers:
  - url: https://api.engrate.io
security:
  - apiKeyAuth: []
paths:
  /schedule-management/v1/send_status_request:
    post:
      tags:
        - schedules
      summary: Send Status Request
      description: >-
        Send a status request to TSO.


        Queries the current status of schedule applications for a specific
        delivery date. The TSO responds with an ACK or CNF containing the
        current status.


        Rate limited to 1 request per 15 minutes per balance group per delivery
        day.


        Args:     request: Status request parameters (sender_id, receiver_id,
        date)     org_uid: Organization UID from request headers     service:
        Status request service


        Returns:     StatusRequestResponse with message_id and status


        Raises:     429: Rate limit exceeded (max 1 per 15 min)     400: Invalid
        request parameters     502: TSO communication error
      operationId: send_status_request_schedule_management_v1_send_status_request_post
      requestBody:
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/StatusRequestCreate'
        required: true
      responses:
        '200':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/StatusRequestResponse'
          description: Successful Response
        '422':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/HTTPValidationError'
          description: Validation Error
components:
  schemas:
    StatusRequestCreate:
      additionalProperties: false
      description: Request body for sending a status request to TSO.
      properties:
        date:
          description: 'Delivery date (YYYY-MM-DD). Example: ''2026-01-24''.'
          format: date
          title: Date
          type: string
        sender_id:
          description: >-
            Your own EIC X code (balance responsible party, 16-character
            organization code starting with '11X' or '10X') as registered with
            the TSO.
          title: Sender Id
          type: string
        tso:
          description: >-
            TSO identifier. DE values: '50HERTZ_DE_TSO' (50Hertz),
            'DE-AMPRION-TSO' (Amprion), 'TTG_DE' (TenneT DE), 'DE-TRANSNETBWTSO'
            (TransnetBW).
          minLength: 1
          title: Tso
          type: string
      required:
        - date
        - sender_id
        - tso
      title: StatusRequestCreate
      type: object
    StatusRequestResponse:
      description: Response from a status request submission to a TSO.
      properties:
        error_message:
          anyOf:
            - type: string
            - type: 'null'
          description: Error description if the request failed.
          title: Error Message
        message_id:
          description: Message identifier assigned to the status request.
          examples:
            - SR-20260326-001
          title: Message Id
          type: string
        next_allowed_at:
          anyOf:
            - type: string
            - type: 'null'
          description: >-
            ISO 8601 datetime when the next request is allowed (present when
            rate-limited).
          title: Next Allowed At
        sent_at:
          anyOf:
            - type: string
            - type: 'null'
          description: ISO 8601 datetime when the request was sent, if successful.
          examples:
            - '2026-03-26T10:00:00+00:00'
          title: Sent At
        status:
          description: 'Submission result: `sent`, `rate_limited`, or `error`.'
          examples:
            - sent
            - rate_limited
          title: Status
          type: string
      required:
        - message_id
        - status
      title: StatusRequestResponse
      type: object
    HTTPValidationError:
      properties:
        detail:
          items:
            $ref: '#/components/schemas/ValidationError'
          title: Detail
          type: array
      title: HTTPValidationError
      type: object
    ValidationError:
      properties:
        ctx:
          title: Context
          type: object
        input:
          title: Input
        loc:
          items:
            anyOf:
              - type: string
              - type: integer
          title: Location
          type: array
        msg:
          title: Message
          type: string
        type:
          title: Error Type
          type: string
      required:
        - loc
        - msg
        - type
      title: ValidationError
      type: object
  securitySchemes:
    apiKeyAuth:
      in: header
      name: Authorization
      type: apiKey

````