Pluralization forms a noun that denotes more than one instance. API naming usually keeps resource names singular—Book, Publisher, and Author—but RESTful URLs commonly use plural collection names such as /books/1234. section 3.3.2
Regular and irregular collections
Book becomes Books by adding “s,” but Foot requires the irregular collection name feet. Person creates a choice between persons and people, so the collection convention must remain clear and unambiguous. section 3.3.2
Apply these naming rules:
- Keep API resource names singular when they represent one resource. section 3.3.2
- Choose collection names deliberately when ordinary pluralization produces an irregular or ambiguous result. section 3.3.2
