Query

Every GraphQL schema has a root type for both queries and mutations. The query type defines GraphQL operations that retrieve data from the server.

For more information, see "About queries."

Connections

marketplaceListings (MarketplaceListingConnection!)

Look up Marketplace listings

Argument Type Description
adminId ID

Select listings that can be administered by the specified user.

after String

Returns the elements in the list that come after the specified global ID.

allStates Boolean

Select listings visible to the viewer even if they are not approved. If omitted or false, only approved listings will be returned.

before String

Returns the elements in the list that come before the specified global ID.

categorySlug String

Select only listings with the given category.

first Int

Returns the first n elements from the list.

last Int

Returns the last n elements from the list.

organizationId ID

Select listings for products owned by the specified organization.

primaryCategoryOnly Boolean

Select only listings where the primary category matches the given category slug.

slugs [String]

Select the listings with these slugs, if they are visible to the viewer.

viewerCanAdmin Boolean

Select listings to which user has admin access. If omitted, listings visible to the viewer are returned.

withFreeTrialsOnly Boolean

Select only listings that offer a free trial.

search (SearchResultItemConnection!)

Perform a search across resources.

Argument Type Description
after String

Returns the elements in the list that come after the specified global ID.

before String

Returns the elements in the list that come before the specified global ID.

first Int

Returns the first n elements from the list.

last Int

Returns the last n elements from the list.

query String!

The search string to look for.

type SearchType!

The types of search items to search within.

Fields

codeOfConduct (CodeOfConduct)

Look up a code of conduct by its key

Argument Type Description
key String!

The code of conduct's key

codesOfConduct ([CodeOfConduct])

Look up a code of conduct by its key

license (License)

Look up an open source license by its key

Argument Type Description
key String!

The license's downcased SPDX ID

licenses ([License]!)

Return a list of known open source licenses

marketplaceCategories ([MarketplaceCategory!]!)

Get alphabetically sorted list of Marketplace categories

Argument Type Description
excludeEmpty Boolean

Exclude categories with no listings.

marketplaceCategory (MarketplaceCategory)

Look up a Marketplace category by its slug.

Argument Type Description
slug String!

The URL slug of the category.

marketplaceListing (MarketplaceListing)

Look up a single Marketplace listing

Argument Type Description
slug String!

Select the listing that matches this slug. It's the short name of the listing used in its URL.

meta (GitHubMetadata!)

Return information about the GitHub instance

node (Node)

Fetches an object given its ID.

Argument Type Description
id ID!

ID of the object.

nodes ([Node]!)

Lookup nodes by a list of IDs.

Argument Type Description
ids [ID!]!

The list of node IDs.

organization (Organization)

Lookup a organization by login.

Argument Type Description
login String!

The organization's login.

rateLimit (RateLimit)

The client's rate limit information.

Argument Type Description
dryRun Boolean

If true, calculate the cost for the query without evaluating it

relay (Query!)

Hack to workaround https://github.com/facebook/relay/issues/112 re-exposing the root query object

repository (Repository)

Lookup a given repository by the owner and repository name.

Argument Type Description
name String!

The name of the repository

owner String!

The login field of a user or organization

repositoryOwner (RepositoryOwner)

Lookup a repository owner (ie. either a User or an Organization) by login.

Argument Type Description
login String!

The username to lookup the owner by.

resource (UniformResourceLocatable)

Lookup resource by a URL.

Argument Type Description
url URI!

The URL.

topic (Topic)

Look up a topic by name.

Argument Type Description
name String!

The topic's name.

user (User)

Lookup a user by login.

Argument Type Description
login String!

The user's login.

viewer (User!)

The currently authenticated user.