Number History API

Returns the win history for a number the user searched.

Method	GET
Path	/api/v1/numberHistory/{number}/{type}
Full URL	https://backend.4dnum.com/api/v1/numberHistory/{number}/{type}

Request

Attribute	Type	Mandatory	Example	Description
number	String	Yes	1568	The number to look up.
type	String	Yes	M	Abbreviation company name. One of M, PMP, ST, SG, STC, EE, CS, H, P, GD.

Response

An array of history entries.

Attribute	Type	Example	Description
type	String	PMP	Company the number won under.
number	String	1685	The winning number.
drawDate	String	2024-02-11	Date the number won.
prize	String	3RD	Prize tier won. See table below.
gapDate	Integer	33	Gap, in days, to the next winning occurrence.
image	String	https://backend.4dnum.com/images.svg	Logo of the company the number won under.

Prize values

Value	Meaning
1ST	First prize
2ND	Second prize
3RD	Third prize
SPE	Special prize
CON	Consolation

Example

curl https://backend.4dnum.com/api/v1/numberHistory/1568/M

[
  {
    "type": "PMP",
    "number": "1685",
    "drawDate": "2024-02-11",
    "prize": "3RD",
    "gapDate": 33,
    "image": "https://backend.4dnum.com/images.svg"
  }
]

tip

This is the same entry shape as history in Number Analysis. Use Number Analysis when you also need the totals and lucky book data; use this endpoint when you only need the history list.