Geocode Postcode API

Introduction

Geocode Postcode API is a geolocation tool that provides users with a simple way to retrieve the geographical coordinates and boundaries of a postal code or ZIP code. Additionally, users can provide location coordinates to get the postal code it belongs to.

The API has a range of potential use cases across multiple domains. In the e-commerce industry, it can be utilized to enhance the accuracy of shipping and delivery processes. Similarly, in the logistics and delivery sector, the API can assist with optimizing routes, resulting in faster deliveries. Online mapping services and location-based apps can leverage the API to recommend nearby businesses and attractions based on a user's geographical location. These are just a few examples of the practical applications of the API that can enhance user experiences in various domains.

POST https://api.nextbillion.io/postalcode?{Key}

Parameters

Loading...

Request Body

Loading...

Note

  1. The user can include only the at parameter in the API request to obtain information about the postal code a specific geographic coordinate belongs to.


    For example:

    1{     
    2"at":{"lat": 28.661332, "lng":77.197106},
    3} 
  2. To retrieve information about a specific postal code, include both the postalcode and the country parameter in the request.


    For example:

    1    {    
    2    "postalcode": "110007",
    3    "country": "India"
    4    }
  3. We do not recommend using both postalcode and at together in a single request

Response Schema

Loading...

Sample Request

1curl --location --request POST 'https://api.nextbillion.io/postalcode?key=<your_api_key>' \
2--header 'Content-Type: application/json' \
3--data-raw '{
4"at":{"lat": 28.661332, "lng":77.197106},
5"country": "India"
6}'

Sample Response

1{
2   "places": [
3       {
4           "geopoint": {
5               "lat": 28.67757398,
6               "lng": 77.2010756
7           },
8           "country": "India",
9           "state": "Delhi",
10           "district": "North Delhi",
11           "subDistrict": "",
12           "postalCode": "110007",
13           "address": "North Delhi,Delhi,India,110007",
14           "boundary": {
15               "multiPolygon": [
16                   {
17                       "polygon": [
18                           {
19                               "points": [
20                                   {
21                                       "lat": 28.666,
22                                       "lng": 77.2087
23                                   },
24                                   {
25                                       "lat": 28.6658,
26                                       "lng": 77.2084
27                                   },
28                                   {
29                                       "lat": 28.6659,
30                                       "lng": 77.2078
31                                   },
32                                   {
33                                       "lat": 28.6658,
34                                       "lng": 77.207
35                                   },
36                                   {
37                                       "lat": 28.6657,
38                                       "lng": 77.206
39                                   },
40                                   {
41                                       "lat": 28.6655,
42                                       "lng": 77.2054
43                                   },
44                                   {
45                                       "lat": 28.6652,
46                                       "lng": 77.2046
47                                   },
48                                   {
49                                       "lat": 28.665,
50                                       "lng": 77.2047
51                                   },
52                                   {
53                                       "lat": 28.6648,
54                                       "lng": 77.2048
55                                   },
56                                   {
57                                       "lat": 28.6641,
58                                       "lng": 77.2045
59                                   },
60                                   {
61                                       "lat": 28.6635,
62                                       "lng": 77.2043
63                                   },
64                                   {
65                                       "lat": 28.6634,
66                                       "lng": 77.2047
67                                   },
68                                   {
69                                       "lat": 28.6626,
70                                       "lng": 77.2044
71                                   },
72                                   {
73                                       "lat": 28.6626,
74                                       "lng": 77.2054
75                                   },
76                                   {
77                                       "lat": 28.6617,
78                                       "lng": 77.205
79                                   },
80                                   {
81                                       "lat": 28.6615,
82                                       "lng": 77.2049
83                                   },
84                                   {
85                                       "lat": 28.661,
86                                       "lng": 77.2043
87                                   },
88                                   {
89                                       "lat": 28.6607,
90                                       "lng": 77.2039
91                                   },
92                                   {
93                                       "lat": 28.6606,
94                                       "lng": 77.2037
95                                   },
96                                   {
97                                       "lat": 28.6605,
98                                       "lng": 77.2037
99                                   },
100                                   {
101                                       "lat": 28.6602,
102                                       "lng": 77.2035
103                                   },
104                                   {
105                                       "lat": 28.6594,
106                                       "lng": 77.2031
107                                   },
108                                   {
109                                       "lat": 28.6592,
110                                       "lng": 77.2031
111                                   },
112                                   {
113                                       "lat": 28.6588,
114                                       "lng": 77.2031
115                                   },
116                                   {
117                                       "lat": 28.6588,
118                                       "lng": 77.2029
119                                   },
120                                   {
121                                       "lat": 28.6548,
122                                       "lng": 77.2001
123                                   },
124                                   {
125                                       "lat": 28.6556,
126                                       "lng": 77.1985
127                                   },
128                                   {
129                                       "lat": 28.6557,
130                                       "lng": 77.1983
131                                   },
132                                   {
133                                       "lat": 28.6565,
134                                       "lng": 77.1967
135                                   },
136                                   {
137                                       "lat": 28.6569,
138                                       "lng": 77.196
139                                   },
140                                   {
141                                       "lat": 28.6571,
142                                       "lng": 77.1955
143                                   },
144                                   {
145                                       "lat": 28.6576,
146                                       "lng": 77.1959
147                                   },
148                                   {
149                                       "lat": 28.6579,
150                                       "lng": 77.1961
151                                   },
152                                   {
153                                       "lat": 28.658,
154                                       "lng": 77.1962
155                                   },
156                                   {
157                                       "lat": 28.6582,
158                                       "lng": 77.1963
159                                   },
160                                   {
161                                       "lat": 28.6584,
162                                       "lng": 77.1964
163                                   },
164                                   {
165                                       "lat": 28.6585,
166                                       "lng": 77.1965
167                                   },
168                                   {
169                                       "lat": 28.6587,
170                                       "lng": 77.1966
171                                   },
172                                   {
173                                       "lat": 28.6586,
174                                       "lng": 77.1947
175                                   },
176                                   {
177                                       "lat": 28.6586,
178                                       "lng": 77.1943
179                                   },
180                                   {
181                                       "lat": 28.6597,
182                                       "lng": 77.194
183                                   },
184                                   {
185                                       "lat": 28.6598,
186                                       "lng": 77.194
187                                   },
188                                   {
189                                       "lat": 28.6599,
190                                       "lng": 77.1938
191                                   },
192                                   {
193                                       "lat": 28.6601,
194                                       "lng": 77.1937
195                                   },
196                                   {
197                                       "lat": 28.6603,
198                                       "lng": 77.1935
199                                   },
200                                   {
201                                       "lat": 28.6604,
202                                       "lng": 77.1935
203                                   },
204                                   {
205                                       "lat": 28.6611,
206                                       "lng": 77.1938
207                                   },
208                                   {
209                                       "lat": 28.6614,
210                                       "lng": 77.1939
211                                   },
212                                   {
213                                       "lat": 28.6613,
214                                       "lng": 77.1933
215                                   },
216                                   {
217                                       "lat": 28.6614,
218                                       "lng": 77.1922
219                                   },
220                                   {
221                                       "lat": 28.6614,
222                                       "lng": 77.1915
223                                   },
224                                   {
225                                       "lat": 28.6615,
226                                       "lng": 77.1909
227                                   },
228                                   {
229                                       "lat": 28.6617,
230                                       "lng": 77.1897
231                                   },
232                                   {
233                                       "lat": 28.6619,
234                                       "lng": 77.1889
235                                   },
236                                   {
237                                       "lat": 28.6619,
238                                       "lng": 77.1886
239                                   },
240                                   {
241                                       "lat": 28.6623,
242                                       "lng": 77.1873
243                                   },
244                                   {
245                                       "lat": 28.6625,
246                                       "lng": 77.1868
247                                   },
248                                   {
249                                       "lat": 28.662,
250                                       "lng": 77.1865
251                                   },
252                                   {
253                                       "lat": 28.6613,
254                                       "lng": 77.186
255                                   },
256                                   {
257                                       "lat": 28.6609,
258                                       "lng": 77.1858
259                                   },
260                                   {
261                                       "lat": 28.6612,
262                                       "lng": 77.1849
263                                   },
264                                   {
265                                       "lat": 28.6615,
266                                       "lng": 77.184
267                                   },
268                                   {
269                                       "lat": 28.6618,
270                                       "lng": 77.1834
271                                   },
272                                   {
273                                       "lat": 28.6621,
274                                       "lng": 77.1827
275                                   },
276                                   {
277                                       "lat": 28.6626,
278                                       "lng": 77.1821
279                                   },
280                                   {
281                                       "lat": 28.6635,
282                                       "lng": 77.1805
283                                   },
284                                   {
285                                       "lat": 28.6668,
286                                       "lng": 77.1821
287                                   },
288                                   {
289                                       "lat": 28.6699,
290                                       "lng": 77.1834
291                                   },
292                                   {
293                                       "lat": 28.67,
294                                       "lng": 77.1832
295                                   },
296                                   {
297                                       "lat": 28.6702,
298                                       "lng": 77.1833
299                                   },
300                                   {
301                                       "lat": 28.671,
302                                       "lng": 77.1838
303                                   },
304                                   {
305                                       "lat": 28.6714,
306                                       "lng": 77.1842
307                                   },
308                                   {
309                                       "lat": 28.6717,
310                                       "lng": 77.1845
311                                   },
312                                   {
313                                       "lat": 28.672,
314                                       "lng": 77.1851
315                                   },
316                                   {
317                                       "lat": 28.6723,
318                                       "lng": 77.1854
319                                   },
320                                   {
321                                       "lat": 28.6728,
322                                       "lng": 77.1861
323                                   },
324                                   {
325                                       "lat": 28.6731,
326                                       "lng": 77.1864
327                                   },
328                                   {
329                                       "lat": 28.6736,
330                                       "lng": 77.187
331                                   },
332                                   {
333                                       "lat": 28.6743,
334                                       "lng": 77.1879
335                                   },
336                                   {
337                                       "lat": 28.6754,
338                                       "lng": 77.1887
339                                   },
340                                   {
341                                       "lat": 28.6764,
342                                       "lng": 77.1888
343                                   },
344                                   {
345                                       "lat": 28.6767,
346                                       "lng": 77.1887
347                                   },
348                                   {
349                                       "lat": 28.6773,
350                                       "lng": 77.1882
351                                   },
352                                   {
353                                       "lat": 28.6774,
354                                       "lng": 77.1887
355                                   },
356                                   {
357                                       "lat": 28.6776,
358                                       "lng": 77.1886
359                                   },
360                                   {
361                                       "lat": 28.678,
362                                       "lng": 77.1882
363                                   },
364                                   {
365                                       "lat": 28.6785,
366                                       "lng": 77.1877
367                                   },
368                                   {
369                                       "lat": 28.6798,
370                                       "lng": 77.1859
371                                   },
372                                   {
373                                       "lat": 28.6801,
374                                       "lng": 77.1856
375                                   },
376                                   {
377                                       "lat": 28.6804,
378                                       "lng": 77.1854
379                                   },
380                                   {
381                                       "lat": 28.6819,
382                                       "lng": 77.1887
383                                   },
384                                   {
385                                       "lat": 28.6824,
386                                       "lng": 77.1898
387                                   },
388                                   {
389                                       "lat": 28.6845,
390                                       "lng": 77.1887
391                                   },
392                                   {
393                                       "lat": 28.6867,
394                                       "lng": 77.1876
395                                   },
396                                   {
397                                       "lat": 28.6868,
398                                       "lng": 77.1876
399                                   },
400                                   {
401                                       "lat": 28.6908,
402                                       "lng": 77.1855
403                                   },
404                                   {
405                                       "lat": 28.6909,
406                                       "lng": 77.1855
407                                   },
408                                   {
409                                       "lat": 28.6907,
410                                       "lng": 77.1859
411                                   },
412                                   {
413                                       "lat": 28.6906,
414                                       "lng": 77.1862
415                                   },
416                                   {
417                                       "lat": 28.6903,
418                                       "lng": 77.1869
419                                   },
420                                   {
421                                       "lat": 28.6902,
422                                       "lng": 77.1869
423                                   },
424                                   {
425                                       "lat": 28.69,
426                                       "lng": 77.1875
427                                   },
428                                   {
429                                       "lat": 28.6898,
430                                       "lng": 77.188
431                                   },
432                                   {
433                                       "lat": 28.6896,
434                                       "lng": 77.1883
435                                   },
436                                   {
437                                       "lat": 28.6894,
438                                       "lng": 77.189
439                                   },
440                                   {
441                                       "lat": 28.6891,
442                                       "lng": 77.1896
443                                   },
444                                   {
445                                       "lat": 28.6889,
446                                       "lng": 77.1899
447                                   },
448                                   {
449                                       "lat": 28.6884,
450                                       "lng": 77.1911
451                                   },
452                                   {
453                                       "lat": 28.6884,
454                                       "lng": 77.1912
455                                   },
456                                   {
457                                       "lat": 28.6891,
458                                       "lng": 77.1916
459                                   },
460                                   {
461                                       "lat": 28.6891,
462                                       "lng": 77.1925
463                                   },
464                                   {
465                                       "lat": 28.6893,
466                                       "lng": 77.1929
467                                   },
468                                   {
469                                       "lat": 28.6898,
470                                       "lng": 77.1927
471                                   },
472                                   {
473                                       "lat": 28.6905,
474                                       "lng": 77.1922
475                                   },
476                                   {
477                                       "lat": 28.6907,
478                                       "lng": 77.1925
479                                   },
480                                   {
481                                       "lat": 28.6912,
482                                       "lng": 77.1927
483                                   },
484                                   {
485                                       "lat": 28.6913,
486                                       "lng": 77.1928
487                                   },
488                                   {
489                                       "lat": 28.6915,
490                                       "lng": 77.1929
491                                   },
492                                   {
493                                       "lat": 28.6918,
494                                       "lng": 77.1931
495                                   },
496                                   {
497                                       "lat": 28.692,
498                                       "lng": 77.1932
499                                   },
500                                   {
501                                       "lat": 28.6928,
502                                       "lng": 77.1937
503                                   },
504                                   {
505                                       "lat": 28.6933,
506                                       "lng": 77.1939
507                                   },
508                                   {
509                                       "lat": 28.6938,
510                                       "lng": 77.1943
511                                   },
512                                   {
513                                       "lat": 28.6941,
514                                       "lng": 77.1944
515                                   },
516                                   {
517                                       "lat": 28.6943,
518                                       "lng": 77.1945
519                                   },
520                                   {
521                                       "lat": 28.6953,
522                                       "lng": 77.1947
523                                   },
524                                   {
525                                       "lat": 28.6942,
526                                       "lng": 77.1978
527                                   },
528                                   {
529                                       "lat": 28.6936,
530                                       "lng": 77.1994
531                                   },
532                                   {
533                                       "lat": 28.6929,
534                                       "lng": 77.2013
535                                   },
536                                   {
537                                       "lat": 28.6928,
538                                       "lng": 77.2011
539                                   },
540                                   {
541                                       "lat": 28.6926,
542                                       "lng": 77.201
543                                   },
544                                   {
545                                       "lat": 28.6925,
546                                       "lng": 77.201
547                                   },
548                                   {
549                                       "lat": 28.692,
550                                       "lng": 77.201
551                                   },
552                                   {
553                                       "lat": 28.692,
554                                       "lng": 77.2011
555                                   },
556                                   {
557                                       "lat": 28.6915,
558                                       "lng": 77.2012
559                                   },
560                                   {
561                                       "lat": 28.6912,
562                                       "lng": 77.2013
563                                   },
564                                   {
565                                       "lat": 28.6909,
566                                       "lng": 77.2014
567                                   },
568                                   {
569                                       "lat": 28.6907,
570                                       "lng": 77.2014
571                                   },
572                                   {
573                                       "lat": 28.6903,
574                                       "lng": 77.2016
575                                   },
576                                   {
577                                       "lat": 28.6902,
578                                       "lng": 77.2016
579                                   },
580                                   {
581                                       "lat": 28.6899,
582                                       "lng": 77.2017
583                                   },
584                                   {
585                                       "lat": 28.6898,
586                                       "lng": 77.2018
587                                   },
588                                   {
589                                       "lat": 28.6895,
590                                       "lng": 77.2021
591                                   },
592                                   {
593                                       "lat": 28.6898,
594                                       "lng": 77.2024
595                                   },
596                                   {
597                                       "lat": 28.6899,
598                                       "lng": 77.2026
599                                   },
600                                   {
601                                       "lat": 28.69,
602                                       "lng": 77.2027
603                                   },
604                                   {
605                                       "lat": 28.6907,
606                                       "lng": 77.2035
607                                   },
608                                   {
609                                       "lat": 28.6915,
610                                       "lng": 77.2045
611                                   },
612                                   {
613                                       "lat": 28.6919,
614                                       "lng": 77.2049
615                                   },
616                                   {
617                                       "lat": 28.6927,
618                                       "lng": 77.2056
619                                   },
620                                   {
621                                       "lat": 28.6927,
622                                       "lng": 77.2058
623                                   },
624                                   {
625                                       "lat": 28.6937,
626                                       "lng": 77.2064
627                                   },
628                                   {
629                                       "lat": 28.6939,
630                                       "lng": 77.2065
631                                   },
632                                   {
633                                       "lat": 28.6941,
634                                       "lng": 77.2067
635                                   },
636                                   {
637                                       "lat": 28.6951,
638                                       "lng": 77.2074
639                                   },
640                                   {
641                                       "lat": 28.6954,
642                                       "lng": 77.2075
643                                   },
644                                   {
645                                       "lat": 28.6969,
646                                       "lng": 77.2085
647                                   },
648                                   {
649                                       "lat": 28.6971,
650                                       "lng": 77.2087
651                                   },
652                                   {
653                                       "lat": 28.6969,
654                                       "lng": 77.2093
655                                   },
656                                   {
657                                       "lat": 28.6971,
658                                       "lng": 77.2094
659                                   },
660                                   {
661                                       "lat": 28.6967,
662                                       "lng": 77.2106
663                                   },
664                                   {
665                                       "lat": 28.6964,
666                                       "lng": 77.2114
667                                   },
668                                   {
669                                       "lat": 28.6961,
670                                       "lng": 77.2121
671                                   },
672                                   {
673                                       "lat": 28.6957,
674                                       "lng": 77.2131
675                                   },
676                                   {
677                                       "lat": 28.6955,
678                                       "lng": 77.2134
679                                   },
680                                   {
681                                       "lat": 28.6947,
682                                       "lng": 77.2156
683                                   },
684                                   {
685                                       "lat": 28.6947,
686                                       "lng": 77.2158
687                                   },
688                                   {
689                                       "lat": 28.6946,
690                                       "lng": 77.2161
691                                   },
692                                   {
693                                       "lat": 28.6943,
694                                       "lng": 77.2166
695                                   },
696                                   {
697                                       "lat": 28.694,
698                                       "lng": 77.2175
699                                   },
700                                   {
701                                       "lat": 28.6935,
702                                       "lng": 77.219
703                                   },
704                                   {
705                                       "lat": 28.6933,
706                                       "lng": 77.2196
707                                   },
708                                   {
709                                       "lat": 28.6932,
710                                       "lng": 77.22
711                                   },
712                                   {
713                                       "lat": 28.693,
714                                       "lng": 77.2203
715                                   },
716                                   {
717                                       "lat": 28.6929,
718                                       "lng": 77.2204
719                                   },
720                                   {
721                                       "lat": 28.6926,
722                                       "lng": 77.2207
723                                   },
724                                   {
725                                       "lat": 28.6923,
726                                       "lng": 77.2209
727                                   },
728                                   {
729                                       "lat": 28.6921,
730                                       "lng": 77.2209
731                                   },
732                                   {
733                                       "lat": 28.692,
734                                       "lng": 77.2205
735                                   },
736                                   {
737                                       "lat": 28.6912,
738                                       "lng": 77.22
739                                   },
740                                   {
741                                       "lat": 28.6902,
742                                       "lng": 77.2198
743                                   },
744                                   {
745                                       "lat": 28.6898,
746                                       "lng": 77.2197
747                                   },
748                                   {
749                                       "lat": 28.6891,
750                                       "lng": 77.2193
751                                   },
752                                   {
753                                       "lat": 28.6881,
754                                       "lng": 77.2185
755                                   },
756                                   {
757                                       "lat": 28.6875,
758                                       "lng": 77.2185
759                                   },
760                                   {
761                                       "lat": 28.6869,
762                                       "lng": 77.2188
763                                   },
764                                   {
765                                       "lat": 28.6868,
766                                       "lng": 77.2187
767                                   },
768                                   {
769                                       "lat": 28.6867,
770                                       "lng": 77.2187
771                                   },
772                                   {
773                                       "lat": 28.6863,
774                                       "lng": 77.2193
775                                   },
776                                   {
777                                       "lat": 28.686,
778                                       "lng": 77.2196
779                                   },
780                                   {
781                                       "lat": 28.6857,
782                                       "lng": 77.2198
783                                   },
784                                   {
785                                       "lat": 28.6845,
786                                       "lng": 77.2196
787                                   },
788                                   {
789                                       "lat": 28.6836,
790                                       "lng": 77.2194
791                                   },
792                                   {
793                                       "lat": 28.6821,
794                                       "lng": 77.219
795                                   },
796                                   {
797                                       "lat": 28.6816,
798                                       "lng": 77.2188
799                                   },
800                                   {
801                                       "lat": 28.6811,
802                                       "lng": 77.2186
803                                   },
804                                   {
805                                       "lat": 28.6806,
806                                       "lng": 77.2184
807                                   },
808                                   {
809                                       "lat": 28.6799,
810                                       "lng": 77.2182
811                                   },
812                                   {
813                                       "lat": 28.6791,
814                                       "lng": 77.2181
815                                   },
816                                   {
817                                       "lat": 28.6772,
818                                       "lng": 77.2178
819                                   },
820                                   {
821                                       "lat": 28.6766,
822                                       "lng": 77.2176
823                                   },
824                                   {
825                                       "lat": 28.6763,
826                                       "lng": 77.2175
827                                   },
828                                   {
829                                       "lat": 28.6754,
830                                       "lng": 77.2173
831                                   },
832                                   {
833                                       "lat": 28.675,
834                                       "lng": 77.2171
835                                   },
836                                   {
837                                       "lat": 28.6742,
838                                       "lng": 77.2168
839                                   },
840                                   {
841                                       "lat": 28.6737,
842                                       "lng": 77.2168
843                                   },
844                                   {
845                                       "lat": 28.674,
846                                       "lng": 77.216
847                                   },
848                                   {
849                                       "lat": 28.674,
850                                       "lng": 77.2156
851                                   },
852                                   {
853                                       "lat": 28.6741,
854                                       "lng": 77.2153
855                                   },
856                                   {
857                                       "lat": 28.6741,
858                                       "lng": 77.2151
859                                   },
860                                   {
861                                       "lat": 28.6742,
862                                       "lng": 77.2149
863                                   },
864                                   {
865                                       "lat": 28.6743,
866                                       "lng": 77.2147
867                                   },
868                                   {
869                                       "lat": 28.6745,
870                                       "lng": 77.2146
871                                   },
872                                   {
873                                       "lat": 28.6746,
874                                       "lng": 77.2145
875                                   },
876                                   {
877                                       "lat": 28.6748,
878                                       "lng": 77.2145
879                                   },
880                                   {
881                                       "lat": 28.6749,
882                                       "lng": 77.2145
883                                   },
884                                   {
885                                       "lat": 28.6751,
886                                       "lng": 77.2144
887                                   },
888                                   {
889                                       "lat": 28.6751,
890                                       "lng": 77.2143
891                                   },
892                                   {
893                                       "lat": 28.6751,
894                                       "lng": 77.2141
895                                   },
896                                   {
897                                       "lat": 28.675,
898                                       "lng": 77.2138
899                                   },
900                                   {
901                                       "lat": 28.6747,
902                                       "lng": 77.2135
903                                   },
904                                   {
905                                       "lat": 28.6745,
906                                       "lng": 77.213
907                                   },
908                                   {
909                                       "lat": 28.6742,
910                                       "lng": 77.2122
911                                   },
912                                   {
913                                       "lat": 28.6743,
914                                       "lng": 77.2122
915                                   },
916                                   {
917                                       "lat": 28.6743,
918                                       "lng": 77.2121
919                                   },
920                                   {
921                                       "lat": 28.6743,
922                                       "lng": 77.212
923                                   },
924                                   {
925                                       "lat": 28.6742,
926                                       "lng": 77.212
927                                   },
928                                   {
929                                       "lat": 28.6741,
930                                       "lng": 77.212
931                                   },
932                                   {
933                                       "lat": 28.674,
934                                       "lng": 77.2118
935                                   },
936                                   {
937                                       "lat": 28.6739,
938                                       "lng": 77.2117
939                                   },
940                                   {
941                                       "lat": 28.6737,
942                                       "lng": 77.2116
943                                   },
944                                   {
945                                       "lat": 28.6732,
946                                       "lng": 77.2115
947                                   },
948                                   {
949                                       "lat": 28.6726,
950                                       "lng": 77.2113
951                                   },
952                                   {
953                                       "lat": 28.6722,
954                                       "lng": 77.2111
955                                   },
956                                   {
957                                       "lat": 28.6717,
958                                       "lng": 77.2106
959                                   },
960                                   {
961                                       "lat": 28.6709,
962                                       "lng": 77.2102
963                                   },
964                                   {
965                                       "lat": 28.6701,
966                                       "lng": 77.2101
967                                   },
968                                   {
969                                       "lat": 28.6696,
970                                       "lng": 77.21
971                                   },
972                                   {
973                                       "lat": 28.6692,
974                                       "lng": 77.2099
975                                   },
976                                   {
977                                       "lat": 28.6677,
978                                       "lng": 77.2094
979                                   },
980                                   {
981                                       "lat": 28.6674,
982                                       "lng": 77.2092
983                                   },
984                                   {
985                                       "lat": 28.6668,
986                                       "lng": 77.209
987                                   },
988                                   {
989                                       "lat": 28.666,
990                                       "lng": 77.2087
991                                   }
992                               ]
993                           }
994                       ]
995                   }
996               ]
997           }
998       }
999   ]
1000}
1001
1002
1003

API Query Limits

  1. Nextbillion.ai allows a maximum rate limit of 6000 queries per minute or 100 queries/second for continuous requests. Note: We can increase the quota if needed on request. Contact [email protected] for more details.

  2. Only 1 postalcode is allowed per request

  3. Only 1 at location is allowed per request

API Error Codes

Response CodeDescriptionAdditional Notes
200Normal success case.Normal success case.
400Input validation failed.There is a missing or invalid parameter or a parameter with an invalid value type is added to the request.
401APIKEY not supplied or invalid.-
403APIKEY is valid but does not have access to requested resources.You might be querying for a geographical region which is not valid for your account, or requesting a service which is not enabled for you.
404Requested host/path not found.This error occurs when a malformed hostname is used.
422Could not process the request.The request could not be processed due to inappropriate input. Please verify the accuracy of the postal code or the location.
429Too many requests.QPM reached or API request count quota reached.
500Internal Service error.There was an internal issue with Nextbillion.ai services. You can reach out to [email protected] for an explanation.
Multi Geocoding
DIDN'T FIND WHAT YOU LOOKING FOR?