# Get feeds

From **GitHub v3 REST API**.

`GET /feeds`

GitHub Enterprise Server provides several timeline resources in [Atom](http://en.wikipedia.org/wiki/Atom_(standard)) format. The Feeds API lists all the feeds available to the authenticated user:

*   **Timeline**: The GitHub Enterprise Server global public timeline
*   **User**: The public timeline for any user, using [URI template](https://docs.github.com/enterprise-server@3.0/rest/overview/resources-in-the-rest-api#hypermedia)
*   **Current user public**: The public timeline for the authenticated user
*   **Current user**: The private timeline for the authenticated user
*   **Current user actor**: The private timeline for activity created by the authenticated user
*   **Current user organizations**: The private timeline for the organizations the authenticated user is a member of.
*   **Security advisories**: A collection of public announcements that provide information about security-related vulnerabilities in software on GitHub Enterprise Server.

**Note**: Private feeds are only returned when [authenticating via Basic Auth](https://docs.github.com/enterprise-server@3.0/rest/overview/other-authentication-methods#basic-authentication) since current feed URIs use the older, non revocable auth tokens.

## Responses

### `200`

Response

### `application/json`

- Type: `object`

Feed

```json
{
  "_links": {
    "current_user": {
      "href": "https://github.com/octocat.private?token=abc123",
      "type": "application/atom+xml"
    },
    "current_user_actor": {
      "href": "https://github.com/octocat.private.actor?token=abc123",
      "type": "application/atom+xml"
    },
    "current_user_organization": {
      "href": "",
      "type": ""
    },
    "current_user_organizations": [
      {
        "href": "https://github.com/organizations/github/octocat.private.atom?token=abc123",
        "type": "application/atom+xml"
      }
    ],
    "current_user_public": {
      "href": "https://github.com/octocat",
      "type": "application/atom+xml"
    },
    "timeline": {
      "href": "https://github.com/timeline",
      "type": "application/atom+xml"
    },
    "user": {
      "href": "https://github.com/{user}",
      "type": "application/atom+xml"
    }
  },
  "current_user_actor_url": "https://github.com/octocat.private.actor?token=abc123",
  "current_user_organization_url": "",
  "current_user_organization_urls": [
    "https://github.com/organizations/github/octocat.private.atom?token=abc123"
  ],
  "current_user_public_url": "https://github.com/octocat",
  "current_user_url": "https://github.com/octocat.private?token=abc123",
  "timeline_url": "https://github.com/timeline",
  "user_url": "https://github.com/{user}"
}
```

```json
{"description":"Feed","properties":{"_links":{"properties":{"current_user":{"$ref":"#/components/schemas/link-with-type"},"current_user_actor":{"$ref":"#/components/schemas/link-with-type"},"current_user_organization":{"$ref":"#/components/schemas/link-with-type"},"current_user_organizations":{"items":{"$ref":"#/components/schemas/link-with-type"},"type":"array"},"current_user_public":{"$ref":"#/components/schemas/link-with-type"},"security_advisories":{"$ref":"#/components/schemas/link-with-type"},"timeline":{"$ref":"#/components/schemas/link-with-type"},"user":{"$ref":"#/components/schemas/link-with-type"}},"required":["timeline","user"],"type":"object"},"current_user_actor_url":{"example":"https://github.com/octocat.private.actor?token=abc123","type":"string"},"current_user_organization_url":{"example":"https://github.com/octocat-org","type":"string"},"current_user_organization_urls":{"example":["https://github.com/organizations/github/octocat.private.atom?token=abc123"],"items":{"format":"uri","type":"string"},"type":"array"},"current_user_public_url":{"example":"https://github.com/octocat","type":"string"},"current_user_url":{"example":"https://github.com/octocat.private?token=abc123","type":"string"},"timeline_url":{"example":"https://github.com/timeline","type":"string"},"user_url":{"example":"https://github.com/{user}","type":"string"}},"required":["_links","timeline_url","user_url"],"title":"Feed","type":"object"}
```

## Request examples

### cURL

```shell
curl --request GET \
  --url {protocol}://{hostname}/api/v3/feeds
```