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

# Get Increment Request Status

> Check the status of the increment request.



## OpenAPI

````yaml GET /api/v1/eth/staking/direct/increment-request/status/{id}
openapi: 3.0.0
info:
  title: Staking API
  description: API used for staking
  version: 1.0.0
  contact: {}
servers:
  - url: https://api.p2p.org/api
security:
  - bearer: []
tags:
  - name: Aptos
    description: Aptos staking operations (stake, unstake, withdraw, claim).
  - name: Celestia
    description: Celestia staking operations (stake, unstake, redelegate, claim).
  - name: Cosmos
    description: Cosmos Hub staking operations (stake, unstake, redelegate, claim).
  - name: EigenLayer
    description: EigenLayer restaking operations.
  - name: Ethereum
    description: Ethereum staking operations (direct, SSV, pooled).
  - name: Hyperliquid
    description: Hyperliquid staking operations.
  - name: Monad
    description: Monad staking operations (delegate, undelegate, withdraw).
  - name: P2P SSV
    description: P2P-managed SSV validator operations (deposit, claim, withdraw).
  - name: Polkadot
    description: Polkadot staking and nomination pool operations.
  - name: Polygon
    description: Polygon staking operations.
  - name: Pooled Staking
    description: Pooled staking vault operations (deposit, unstake, withdraw).
  - name: Sei
    description: Sei staking operations (stake, unstake, redelegate, claim).
  - name: Solana
    description: Solana staking operations (stake, split, merge, deactivate, withdraw).
  - name: SSV
    description: SSV network validator operations.
  - name: Story
    description: Story network staking operations.
  - name: Sui
    description: Sui staking operations.
  - name: TON
    description: TON staking operations (single nominator, whales pool).
  - name: TRON
    description: TRON staking operations (freeze, delegate, vote, withdraw).
  - name: Unified
    description: Unified multi-chain staking interface.
paths:
  /api/v1/eth/staking/direct/increment-request/status/{id}:
    get:
      tags:
        - Ethereum
      summary: Get Increment Request Status
      description: Check the status of the increment request.
      operationId: eth-increment-request-status
      parameters:
        - name: id
          required: true
          in: path
          description: UUID of the increment request.
          schema:
            type: string
      responses:
        '200':
          description: OK
          content:
            application/json:
              schema:
                allOf:
                  - $ref: '#/components/schemas/SuccessResponse'
                  - type: object
                    properties:
                      result:
                        $ref: '#/components/schemas/EthereumIncrementRequestResponse'
        '400':
          description: Bad request
          content:
            application/json:
              schema:
                allOf:
                  - $ref: '#/components/schemas/ExceptionResponse'
                  - type: object
                    properties:
                      error:
                        $ref: '#/components/schemas/CommonValidationException'
              examples:
                ValidationException:
                  value:
                    error:
                      code: 100101
                      message: >-
                        The data provided is not valid. Please check the request
                        parameters and try again.
                      name: ValidationException
                      type: client
                    result: null
        '401':
          description: Unauthorized
          content:
            application/json:
              schema:
                allOf:
                  - $ref: '#/components/schemas/ExceptionResponse'
                  - type: object
                    properties:
                      error:
                        oneOf:
                          - $ref: '#/components/schemas/AuthNoTokenException'
                          - $ref: '#/components/schemas/AuthWrongTokenException'
              examples:
                NoTokenException:
                  value:
                    error:
                      code: 101111
                      message: >-
                        No Bearer token has been provided. To obtain an
                        authentication token, follow the instructions at
                        https://docs.p2p.org/docs/authentication.
                      name: NoTokenException
                      type: authentication
                    result: null
                WrongTokenException:
                  value:
                    error:
                      code: 101109
                      message: >-
                        An invalid Bearer token has been provided. Please
                        specify the correct authentication token.
                      name: WrongTokenException
                      type: authentication
                    result: null
        '404':
          description: Not found
          content:
            application/json:
              schema:
                allOf:
                  - $ref: '#/components/schemas/ExceptionResponse'
                  - type: object
                    properties:
                      error:
                        $ref: >-
                          #/components/schemas/EthereumIncrementRequestNotFoundException
              examples:
                IncrementRequestNotFoundException:
                  value:
                    error:
                      code: 103147
                      message: Increment request not found
                      name: IncrementRequestNotFoundException
                      type: not_found
                    result: null
        '429':
          $ref: '#/components/responses/TooManyRequests'
        '500':
          description: Internal server error
          content:
            application/json:
              schema:
                allOf:
                  - $ref: '#/components/schemas/ExceptionResponse'
                  - type: object
                    properties:
                      error:
                        $ref: '#/components/schemas/AuthTokenGuardException'
              examples:
                TokenGuardException:
                  value:
                    error:
                      code: 101110
                      message: >-
                        The request could not be performed because the server
                        authorization error occurred.
                      name: TokenGuardException
                      type: server
                    result: null
      security:
        - bearer: []
components:
  schemas:
    SuccessResponse:
      type: object
      properties:
        error:
          type: object
          nullable: true
          default: null
          description: Error object. Always null on successful responses.
        result:
          type: object
          description: Response payload containing the requested data.
      description: Standard API success response envelope wrapping the result payload.
      required:
        - error
        - result
    EthereumIncrementRequestResponse:
      type: object
      properties:
        id:
          type: string
          format: uuid
          example: 8c48cd8d-99cb-4149-8975-f0822fe46d06
          description: UUID of the increment request.
        status:
          type: string
          enum:
            - processing
            - ready
            - cancel
            - error
          description: >-
            <p>Current status of the increment
            request:</p><ul><li><i>processing</i> — request in progress, please
            wait.</li><li><i>ready</i> — request is ready.</li><li><i>cancel</i>
            — request canceled due to an error or timeout.</li><li><i>error</i>
            — validator data is not valid.</li></ul>
          example: processing
          readOnly: true
        withdrawalAddress:
          type: string
          description: Withdrawal address of the validator.
          example: '0x338EF19fA2eC0fc4d1277B1307a613fA1FBbc0cb'
          pattern: ^0x[a-fA-F0-9]{40}$
        pubkeys:
          description: List of validator public keys.
          example:
            - >-
              0xffC08FcD7cFeF5c70fB2b0e1f2A8EaA690AaE2bDFfa5dBEc4dEef31DcC0B19eB1f9Cebe3E2fe9eefBD9a1BDF6FD89b39
          items:
            type: string
            pattern: ^0x[a-fA-F0-9]{96}$
          type: array
        amountPerValidator:
          type: string
          description: Amount of tokens in Gwei to stake per validator.
          example: '32000000000'
        depositData:
          minItems: 1
          maxItems: 400
          description: Deposit data required for validator activation on the beacon chain.
          type: array
          items:
            $ref: '#/components/schemas/EthereumDepositDataResponse'
        incrementTxs:
          example: []
          description: Transactions to increment the validator stake.
          type: array
          items:
            $ref: '#/components/schemas/EthereumUnsignedTransactionResponse'
        createdAt:
          format: date-time
          type: string
          description: Timestamp of the transaction in the ISO 8601 format.
          example: '2023-08-24T08:14:50.455Z'
          readOnly: true
      required:
        - id
        - status
        - pubkeys
        - amountPerValidator
        - incrementTxs
        - createdAt
    ExceptionResponse:
      type: object
      properties:
        error:
          type: object
          description: Error object containing exception details. Null on success.
        result:
          type: object
          nullable: true
          default: null
          description: Result payload. Always null on error responses.
        requestId:
          type: string
          description: >-
            Identifier of the request (the `x-request-id` header). Quote this
            value to correlate the response with server logs.
          example: 90c16e9e-6e99-4651-a033-60290356df2f
        timestamp:
          type: string
          format: date-time
          description: ISO 8601 timestamp of when the error response was generated.
          example: '2026-05-20T22:29:03.126Z'
      description: Standard API error response envelope wrapping the exception details.
      required:
        - error
        - result
        - timestamp
    CommonValidationException:
      type: object
      properties:
        type:
          type: string
          default: client
          example: client
          description: Exception category.
        code:
          type: integer
          format: int32
          default: 100101
          example: 100101
          description: Numeric error code identifying the exception type.
        message:
          type: string
          default: >-
            The data provided is not valid. Please check the request parameters
            and try again.
          example: >-
            The data provided is not valid. Please check the request parameters
            and try again.
          description: Human-readable error message describing what went wrong.
        errors:
          description: Validation error details when applicable.
          type: array
          items:
            $ref: '#/components/schemas/ValidationErrorResponse'
        name:
          type: string
          default: ValidationException
          example: ValidationException
          description: Exception class name for runtime error identification.
      required:
        - type
        - code
        - message
        - errors
        - name
    AuthNoTokenException:
      type: object
      properties:
        type:
          type: string
          default: authentication
          example: authentication
          description: Exception category.
        code:
          type: integer
          format: int32
          default: 101111
          example: 101111
          description: Numeric error code identifying the exception type.
        message:
          type: string
          default: >-
            No Bearer token has been provided. To obtain an authentication
            token, follow the instructions at
            https://docs.p2p.org/docs/authentication.
          example: >-
            No Bearer token has been provided. To obtain an authentication
            token, follow the instructions at
            https://docs.p2p.org/docs/authentication.
          description: Human-readable error message describing what went wrong.
        name:
          type: string
          default: NoTokenException
          example: NoTokenException
          description: Exception class name for runtime error identification.
      required:
        - type
        - code
        - message
        - name
    AuthWrongTokenException:
      type: object
      properties:
        type:
          type: string
          default: authentication
          example: authentication
          description: Exception category.
        code:
          type: integer
          format: int32
          default: 101109
          example: 101109
          description: Numeric error code identifying the exception type.
        message:
          type: string
          default: >-
            An invalid Bearer token has been provided. Please specify the
            correct authentication token.
          example: >-
            An invalid Bearer token has been provided. Please specify the
            correct authentication token.
          description: Human-readable error message describing what went wrong.
        name:
          type: string
          default: WrongTokenException
          example: WrongTokenException
          description: Exception class name for runtime error identification.
      required:
        - type
        - code
        - message
        - name
    EthereumIncrementRequestNotFoundException:
      type: object
      properties:
        code:
          type: integer
          format: int32
          default: 103147
          example: 103147
          description: Numeric error code identifying the exception type.
        message:
          type: string
          default: Increment request not found
          example: Increment request not found
          description: Human-readable error message describing what went wrong.
        name:
          type: string
          default: IncrementRequestNotFoundException
          example: IncrementRequestNotFoundException
          description: Exception class name for runtime error identification.
      required:
        - code
        - message
        - name
    AuthTokenGuardException:
      type: object
      properties:
        type:
          type: string
          default: server
          example: server
          description: Exception category.
        code:
          type: integer
          format: int32
          default: 101110
          example: 101110
          description: Numeric error code identifying the exception type.
        message:
          type: string
          default: >-
            The request could not be performed because the server authorization
            error occurred.
          example: >-
            The request could not be performed because the server authorization
            error occurred.
          description: Human-readable error message describing what went wrong.
        name:
          type: string
          default: TokenGuardException
          example: TokenGuardException
          description: Exception class name for runtime error identification.
      required:
        - type
        - code
        - message
        - name
    EthereumDepositDataResponse:
      type: object
      properties:
        pubkey:
          type: string
          description: Validator public key.
          example: >-
            0xbe5E9c3Bb9eba1BF4C5eC1c1cbcF85ee2CE2fEC66Ce5460C23eF82332A044FDCabF7011F588CCbD77E73CCe6c4accDF0
          pattern: ^0x[a-fA-F0-9]{96}$
        signature:
          type: string
          description: Validator signature.
          example: >-
            0x15C9D0Bf74BE4ef12b0008Ed53825Da647E0C0FE21c0EfAE2B36E066bf44A5a9b5De0B70cE19F73D8eC5E7237Dde667FE8a99Ad607BddDC4b2aDd4c4Bc57b10ddfe7f0bFb925b48f4d37Cee8f894cEA365CeeA6c4B25a9Ca7DAbDfFdB2EDd6eB
          pattern: ^0x[a-fA-F0-9]{192}$
        depositDataRoot:
          type: string
          description: Hash of the deposit data.
          example: '0xFEDdcB470eAA856c57f466e2f4d4F6971efEA1ED38fdB91bD913EEFFb52C8E24'
          pattern: ^0x[a-fA-F0-9]{64}$
        withdrawalCredentials:
          type: string
          description: Public key of the withdrawal address.
        amount:
          type: string
          description: Deposit amount.
        depositMessageRoot:
          type: string
          description: Cryptographic hash of the Merkle tree’s root.
          readOnly: true
        forkVersion:
          type: string
          description: Version of the Ethereum fork.
        eth2NetworkName:
          type: string
          description: Eth2 network name.
        nonce:
          type: number
          description: >-
            SSV registration nonce assigned to this validator. Returned only for
            MANAGED_SSV requests. Deposit data must be deposited in strictly
            increasing nonce order: deposit data within one request is ordered
            starting from the current onchain nonce, and previously issued
            undeposited deposit data must never be used after requesting new
            deposit data. Depositing out of order produces malformed SSV shares
            and an inactive validator.
          example: 10
        depositCliVersion:
          type: string
          description: Version of the deposit command-line interface.
      required:
        - pubkey
        - signature
        - depositDataRoot
    EthereumUnsignedTransactionResponse:
      type: object
      properties:
        serializeTx:
          type: string
          description: Serialized unsigned transaction.
          example: 0x02f902d70580830167...
          pattern: ^0x([A-Fa-f0-9])+$
          nullable: false
        to:
          type: string
          description: Recipient address for this transaction.
          example: '0x338EF19fA2eC0fc4d1277B1307a613fA1FBbc0cb'
          pattern: ^0x[a-fA-F0-9]{40}$
        gasLimit:
          type: string
          example: '0'
          description: Maximum gas limit for this block.
        data:
          type: string
          example: ''
          description: Transaction data.
        value:
          type: string
          example: '0'
          description: Amount of tokens to send in Wei.
        chainId:
          type: string
          example: '0'
          description: Chain ID this transaction is authorized on, as specified by EIP-155.
        type:
          type: string
          example: '0'
          description: EIP-2718 type of this transaction envelope.
        maxFeePerGas:
          type: string
          example: '0'
          description: >-
            Maximum price per unit of gas this transaction will pay for the
            combined EIP-1559 block's base fee and this transaction's priority
            fee in Wei.
        maxPriorityFeePerGas:
          type: string
          example: '0'
          description: >-
            Price per unit of gas in Wei, which is added to the EIP-1559 block's
            base fee. This added fee is used to incentivize miners to prioritize
            this transaction.
      required:
        - serializeTx
        - to
        - gasLimit
        - data
        - value
        - chainId
        - type
        - maxFeePerGas
        - maxPriorityFeePerGas
    ValidationErrorResponse:
      type: object
      properties:
        property:
          type: string
          description: Name of the property that failed validation.
        constraints:
          type: object
          additionalProperties:
            type: string
          description: Validation constraint details describing what was expected.
      required:
        - property
        - constraints
  responses:
    TooManyRequests:
      description: >-
        Too Many Requests — the client exceeded its rate limit. The response
        advertises when to retry and the active quota via headers.
      headers:
        Retry-After:
          description: Number of seconds to wait before retrying the request.
          schema:
            type: integer
            example: 60
        RateLimit-Limit:
          description: >-
            The request quota (maximum number of requests) for the most
            restrictive applicable window.
          schema:
            type: integer
            example: 120
        RateLimit-Reset:
          description: >-
            Number of seconds until the rate-limit window resets and requests
            are accepted again.
          schema:
            type: integer
            example: 60
        RateLimit-Policy:
          description: >-
            The active rate-limit policy as `<limit>;w=<window-seconds>`,
            comma-separated when multiple windows apply.
          schema:
            type: string
            example: 120;w=60
      content:
        application/json:
          schema:
            type: object
            properties:
              error:
                type: object
                properties:
                  code:
                    type: integer
                  name:
                    type: string
                    example: ThrottlerException
                  message:
                    type: string
                    example: ThrottlerException
                  errors:
                    type: array
                    nullable: true
                    items:
                      type: object
              result:
                type: object
                nullable: true
                example: null
              requestId:
                type: string
                description: >-
                  Identifier of the request (the `x-request-id` header). Quote
                  this value to correlate the response with server logs.
                example: 90c16e9e-6e99-4651-a033-60290356df2f
              timestamp:
                type: string
                format: date-time
                description: ISO 8601 timestamp of when the error response was generated.
                example: '2026-05-20T22:29:03.126Z'
  securitySchemes:
    bearer:
      scheme: bearer
      bearerFormat: JWT
      type: http

````

## Related topics

- [Get Request Status](/reference/eth-nodes-request-status.md)
- [Get VEM Request Status](/reference/eth-vem-status.md)
- [Get All Requests Status](/reference/eth-nodes-request-list.md)
- [Incremental Staking (Top-ups)](/docs/incremental-staking-tops-up.md)
- [Create Staking Increment Request](/reference/eth-increment-request-create.md)