Skip to content
StudyPlug API

Search and filter skills

GET
/api/v1/skills

Parameters

Section titled “ Parameters ”

Query Parameters

Section titled “Query Parameters ”
grade
string

Filter by grade slug

subject
string

Filter by subject slug

topic
string

Filter by topic slug

q
string

Search by name or slug

page
integer
default: 1 >= 1
pageSize
integer
default: 20 >= 1 <= 100

Responses

Section titled “ Responses ”

200

Section titled “200 ”

Paginated list of skills

object
data
object
skills
Array
object
slug
string
name
string
grade
object
slug
string
name
string
order
integer
subject
object
slug
string
name
string
topic
object
slug
string
name
string
standards
Array<object>
object
code
string
Example
3.OA.C.7
framework
string
Example
CCSS-MATH
description
string
meta
object
requestId
string format: uuid
generatedAt
string format: date-time
apiVersion
string
Allowed values: v1
cacheHit
boolean
pagination
object
page
required
integer
pageSize
required
integer
total
required
integer
hasNext
required
boolean

429

Section titled “429 ”

Rate limit exceeded

RFC 7807 Problem Details

object
type
required
string format: uri
title
required
string
status
required
integer
detail
required
string
instance
string
retryAfter

Seconds to wait before retrying (present on 429 responses)

integer
Example
{
  "type": "https://api.studyplug.org/errors/rate-limited",
  "title": "Rate Limit Exceeded",
  "status": 429,
  "detail": "You have exceeded 20 requests per minute. Please wait before retrying.",
  "instance": "/api/v1/skills",
  "retryAfter": 12
}

Headers

Section titled “Headers ”
Retry-After
integer

Seconds until rate limit resets

X-RateLimit-Limit
integer

Max requests per window

X-RateLimit-Remaining
integer
Allowed values: 0

Always 0 when rate limited