# Get an organization secret

From **GitHub v3 REST API**.

`GET /orgs/{org}/actions/secrets/{secret_name}`

Gets a single organization secret without revealing its encrypted value. You must authenticate using an access token with the `admin:org` scope to use this endpoint. GitHub Apps must have the `secrets` organization permission to use this endpoint.

## Parameters

### `org`

- Location: path
- Required: true
- Type: `string`

### `secret_name`

- Location: path
- Required: true
- Type: `string`

secret_name parameter

## Responses

### `200`

Response

### `application/json`

- Type: `object`

Secrets for GitHub Actions for an organization.

```json
{
  "created_at": "2019-08-10T14:59:22Z",
  "name": "GH_TOKEN",
  "selected_repositories_url": "https://api.github.com/orgs/octo-org/actions/secrets/SUPER_SECRET/repositories",
  "updated_at": "2020-01-10T14:59:22Z",
  "visibility": "selected"
}
```

```json
{"description":"Secrets for GitHub Actions for an organization.","properties":{"created_at":{"format":"date-time","type":"string"},"name":{"description":"The name of the secret.","example":"SECRET_TOKEN","type":"string"},"selected_repositories_url":{"example":"https://api.github.com/organizations/org/secrets/my_secret/repositories","format":"uri","type":"string"},"updated_at":{"format":"date-time","type":"string"},"visibility":{"description":"Visibility of a secret","enum":["all","private","selected"],"type":"string"}},"required":["name","created_at","updated_at","visibility"],"title":"Actions Secret for an Organization","type":"object"}
```

## Request examples

### cURL

```shell
curl --request GET \
  --url {protocol}://{hostname}/api/v3/orgs/{org}/actions/secrets/{secret_name}
```
