🛣️REST Resource URL Design Guide

Enter resource names and nesting to expand every path and method pair into a table.

Set by the specification, or convention

StatementWhich
Paths are case-sensitive, while scheme and host are notSpecification
An address with a trailing slash is a different address from one withoutSpecification
The query string is a separate component (the spec says nothing about parameter order, so servers differ)Specification (RFC 3986 3.4)
Collection names are written in the pluralConvention
Only lowercase letters and hyphens are usedConvention
Verbs stay out of the path and actions are split by methodConvention
Nesting is kept within about two levelsConvention

This tool gives no score and no grade. Departures from convention are counted and listed, never judged as right or wrong. Choosing a versioning scheme, a status code or a pagination style each belong to a separate tool.

You Might Also Need

About this tool

Name a collection and an optional sub-collection, choose which methods you will offer, and the tool expands the real path and method pairs into a table. Seeing which methods the collection path and the item path each accept, and what every method does, in one view makes a missing combination obvious while drafting a routing table or a documentation outline. The identifier placeholder can follow the OpenAPI form or the router form.

This tool gives no score and no grade. Instead it separates what the URI specification sets, as of October 2026, from what is industry convention. Paths being case-sensitive and a trailing slash marking a different address are specification; writing collection names in the plural and using only lowercase and hyphens are convention. Departures from convention are counted and listed without any verdict on which choice is correct.

Choosing a versioning scheme, picking a status code per situation and choosing a pagination style are each handled by separate tools. This tool also leaves out authentication design, request and response body schemas and rate limit design.

Frequently asked questions

Do collection names have to be plural?

No specification requires it; it is a widespread convention. Plural names put the list and the single member naturally under one name and read more easily. Being consistent within the team matters more than which form you pick.

How many levels of nesting should a path have?

There is no fixed limit. That said, when a child is uniquely addressable without its parent identifier, exposing it as its own collection shortens paths and simplifies cache keys. Keep nesting only for relationships where the child has no meaning without the parent.

What does this tool not do?

It does not score or grade, choose a versioning scheme, pick status codes or choose a pagination style. It expands path and method pairs and separates specification from convention.