# Get Lightning invoice

GET https://api.bb.no/v1/deposit-destinations/bitcoin/invoice/{id}

Fetches a Lightning invoice.

## Authentication

x-bb-api-key: Public part of your API key. Starts with `bb/public/`.

Or:

OAuth: Authorization: Bearer <access token>. Required scopes: api:deposits:lightning:read.

[API keys and signing](https://barebitcoin.no/developers/authentication/api-keys)

## Parameters

### id

path parameter · string · required

Can be:
 1. Deposit destination ID. Prefix: `ded_`.
 2. The Lightning invoice itself.



## Examples

### API key

```sh
curl -X GET \
  https://api.bb.no/v1/deposit-destinations/bitcoin/invoice/REPLACE_ID \
  -H "x-bb-api-key: $BB_API_KEY"
```


### OAuth

```sh
curl -X GET \
  https://api.bb.no/v1/deposit-destinations/bitcoin/invoice/REPLACE_ID \
  -H "Authorization: Bearer $BB_TOKEN"
```



## Responses

### 200

OK

Example:

```json
{
  "depositDestinationId": "ded_01JA3QW7E2R9T4Y6V8P0S1D3F5",
  "invoice": "lnbc2500u1pvjluezsp5zyg3zyg3zyg3zyg3zyg3zyg3zyg3zyg3zyg3zyg3zyg3zyg3zygspp5qqqsyqcyq5rqwzqfqqqsyqcyq5rqwzqfqqqsyqcyq5rqwzqfqypqdq5xysxxatsyp3k7enxv4jsxqzpu9qrsgquk0rl77nj30yxdy8j9vdx85fkpmdla2087ne0xh8nhedh8w27kyke0lp53ut353s06fv3qfegext0eh0ymjpf39tuven09sam30g4vgpfna3rh",
  "status": "INVOICE_STATUS_PAID"
}
```

[GetLightningInvoiceResponse](https://barebitcoin.no/developers/models/GetLightningInvoiceResponse).

Source: https://barebitcoin.no/developers/api/transfers/get-lightning-invoice


## Model: GetLightningInvoiceResponse





### depositDestinationId

Type: string.







### invoice

Type: string.







### status

Type: string · enum.



Values: INVOICE_STATUS_UNPAID, INVOICE_STATUS_PENDING, INVOICE_STATUS_PAID, INVOICE_STATUS_EXPIRED, INVOICE_STATUS_CANCELED

