---
updatedAt: 2026-06-13T01:37:16.000Z
---

Fetch the complete documentation index at: https://developers.pismo.io/pismo-docs/llms.txt. Use this file to discover all available pages before exploring further. Append .md to any documentation page URL to get its markdown version.

# Get eBill registration

Retrieve eBill registration information.

# OpenAPI definition

```json
{
  "openapi": "3.1.0",
  "info": {
    "title": "Banking - Integrated payments",
    "version": "1.0",
    "description": "API responsible for handling and processing integrated payments",
    "contact": {
      "name": "API Support",
      "url": "https://developers.pismo.io/support/"
    },
    "license": {
      "name": "Copyright Pismo"
    }
  },
  "servers": [
    {
      "url": "https://sandbox.pismolabs.io/integrated-payments",
      "description": "Sandbox API server for testing"
    }
  ],
  "security": [
    {
      "BearerAuth": []
    }
  ],
  "components": {
    "parameters": {
      "idempotencyKeyHeader": {
        "name": "x-idempotency-key",
        "in": "header",
        "description": "Unique identifier (UUID) to ensure the operation remains idempotent, allowing for operation repitition without causing unintended effects or duplication. An idempotent operation is one that can be applied multiple times, yet the outcome remains the same. it ensures that network errors, retries, or failures can occur without introducing inconsistencies.\n",
        "required": true,
        "schema": {
          "type": "string"
        },
        "example": "6a17f82d-7365-4451-a83d-09403f05c1ec"
      },
      "accountIdPath": {
        "name": "accountId",
        "in": "path",
        "description": "Your Pismo account ID.",
        "required": true,
        "schema": {
          "type": "string"
        },
        "example": "78123456"
      }
    },
    "schemas": {
      "domain.Error": {
        "type": "object",
        "properties": {
          "code": {
            "type": "string",
            "description": "Error type code.",
            "example": "EIP0001"
          },
          "details": {
            "type": "string",
            "description": "Error details.",
            "example": "Error details"
          },
          "message": {
            "type": "string",
            "description": "Error message describing the error.",
            "example": "error"
          }
        }
      },
      "ebill.GetEbillResponse": {
        "type": "object",
        "properties": {
          "id": {
            "description": "Registration ID.",
            "type": "string"
          },
          "client_request_id": {
            "description": "Client request ID.",
            "type": "string"
          },
          "external_id": {
            "description": "Provider's external ID.",
            "type": "string"
          },
          "status": {
            "description": "Registration status.",
            "type": "string"
          },
          "document_number": {
            "description": "Document number.",
            "type": "string"
          }
        }
      }
    },
    "securitySchemes": {
      "BearerAuth": {
        "type": "http",
        "scheme": "bearer",
        "bearerFormat": "JWT"
      }
    }
  },
  "paths": {
    "/v1/ebill-registration/accounts/{accountId}": {
      "get": {
        "tags": [
          "eBill registration"
        ],
        "summary": "Get eBill registration",
        "description": "Retrieve eBill registration information.",
        "operationId": "get-integrated-payments-api-v1-ebill-registration-accounts-accountId",
        "parameters": [
          {
            "$ref": "#/components/parameters/accountIdPath"
          },
          {
            "$ref": "#/components/parameters/idempotencyKeyHeader"
          }
        ],
        "responses": {
          "200": {
            "description": "Response Body",
            "headers": {
              "x-cid": {
                "description": "Request tracking identifier.",
                "schema": {
                  "type": "string"
                }
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ebill.GetEbillResponse"
                }
              }
            }
          },
          "403": {
            "description": "Forbidden",
            "headers": {
              "x-cid": {
                "description": "Request tracking ID.",
                "schema": {
                  "type": "string"
                }
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/domain.Error"
                },
                "examples": {
                  "EIP0005": {
                    "summary": "Missing required header {x-tenant}",
                    "value": {
                      "code": "EIP0005",
                      "message": "Missing required header: 'x-tenant'"
                    }
                  },
                  "EIP0006": {
                    "summary": "Invalid account id header {x-account-id}",
                    "value": {
                      "code": "EIP0006",
                      "message": "Invalid account id header: 'x-account-id'"
                    }
                  }
                }
              }
            }
          },
          "404": {
            "description": "Not Found",
            "headers": {
              "x-cid": {
                "description": "Request tracking ID.",
                "schema": {
                  "type": "string"
                }
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/domain.Error"
                },
                "examples": {
                  "EIP0088": {
                    "summary": "eBill registration not found",
                    "value": {
                      "code": "EIP0088",
                      "message": "Ebill registration not found"
                    }
                  }
                }
              }
            }
          },
          "500": {
            "description": "Internal Server Error",
            "headers": {
              "x-cid": {
                "description": "Request tracking ID.",
                "schema": {
                  "type": "string"
                }
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/domain.Error"
                },
                "examples": {
                  "EIP0007": {
                    "summary": "Internal error",
                    "value": {
                      "code": "EIP0007",
                      "message": "Internal error"
                    }
                  },
                  "EIP0089": {
                    "summary": "eBill database error",
                    "value": {
                      "code": "EIP0089",
                      "message": "Ebill database error"
                    }
                  }
                }
              }
            }
          }
        }
      }
    }
  }
}
```