# Get a database instance

Retrieves the specified database instance

Endpoint: GET /v1/orgs/{org}/projects/{project}/dbschema/{dbschema}/instance/{dbinstance}
Version: 1.0
Security: x-api-key

## Path parameters:

  - `org` (string, required)
    Organization identifier

  - `project` (string, required)
    Project identifier

  - `dbschema` (string, required)
    Identifier of the database schema

  - `dbinstance` (string, required)
    database instance unique id

## Header parameters:

  - `Harness-Account` (string)
    Identifier field of the account the resource is scoped to. This is required for Authorization methods other than the x-api-key header. If you are using the x-api-key header, this can be skipped.

## Response 200 fields (application/json):

  - `branch` (string)
    branch where the instance is stored

  - `connector` (string, required)
    DB Connector

  - `context` (string)
    Liquibase context

  - `created` (integer, required)
    epoch seconds when the database instance was created

  - `identifier` (string, required)
    identifier of the database instance

  - `lastAppliedTag` (string)
    Most recent tag applied to the database

  - `lastDeployedChangeSetTag` (string, required)
    Tag on last deployed changeSet

  - `liquibaseSubstituteProperties` (object)
    properties to substitute in liquibase changelog

  - `name` (string, required)
    name of the database instance

  - `schemaId` (string)

  - `schemaIdentifier` (string)

  - `tags` (object)
    tags attached to the database instance

  - `toOnboard` (boolean)

  - `updated` (integer)
    epoch seconds when the database instance was last updated

## Response 400 fields (application/json):

  - `message` (string, required)
    error message detail

## Response 403 fields (application/json):

  - `message` (string, required)
    error message detail

## Response 404 fields (application/json):

  - `message` (string, required)
    error message detail

## Response 500 fields (application/json):

  - `message` (string, required)
    error message detail