# github-repositories

**Repository Path**: mirrors_kevva/github-repositories

## Basic Information

- **Project Name**: github-repositories
- **Description**: Get all GitHub repos from a user or an organization
- **Primary Language**: Unknown
- **License**: MIT
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2020-09-25
- **Last Updated**: 2026-05-24

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# github-repositories [![Build Status](https://travis-ci.org/kevva/github-repositories.svg?branch=master)](https://travis-ci.org/kevva/github-repositories)

> Get all GitHub repos from a user or an organization


## Install

```
$ npm install github-repositories
```


## Usage

```js
const githubRepositories = require('github-repositories');

(async () => {
	console.log(await githubRepositories('kevva'));
	//=> [{id: 29258368, name: 'animal-sounds', full_name: 'kevva/animal-sounds', …}, …]
})();
```


## API

### githubRepositories(name, options?)

Returns a `Promise<object[]>` with the the repositories.

#### name

Type: `string`

Username or organization to fetch repos from.

#### options

Type: `object`

##### sort

Type: `string`<br>
Default: `full_name`

Can be one of `created`, `updated`, `pushed`, `full_name`.

##### direction

Type: `string`<br>
Default: `asc` when using `full_name`, otherwise `desc`

Can be one of `asc` or `desc`.

##### token

Type: `string`

Token to authenticate with. Use this to increase the request count. Github supports
up to 60 unauthenticated request per hour. This is also required for accessing private
repos.

If you don't have a token you can generate a new one [here](https://github.com/settings/tokens/new).

##### endpoint

Type: `string`<br>
Default: `https://api.github.com/`

To support [GitHub Enterprise](https://enterprise.github.com/).

Can be set globally with the `GITHUB_ENDPOINT` environment variable.