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.
Parameters
Loading...Request Body
Loading...Note
-
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}
-
To retrieve information about a specific postal code, include both the
postalcode
and thecountry
parameter in the request.
For example:
1 { 2 "postalcode": "110007", 3 "country": "India" 4 }
-
We do not recommend using both
postalcode
andat
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
-
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.
-
Only 1
postalcode
is allowed per request -
Only 1
at
location is allowed per request
API Error Codes
Response Code | Description | Additional Notes |
---|---|---|
200 | Normal success case. | Normal success case. |
400 | Input validation failed. | There is a missing or invalid parameter or a parameter with an invalid value type is added to the request. |
401 | APIKEY not supplied or invalid. | - |
403 | APIKEY 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. |
404 | Requested host/path not found. | This error occurs when a malformed hostname is used. |
422 | Could 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. |
429 | Too many requests. | QPM reached or API request count quota reached. |
500 | Internal Service error. | There was an internal issue with Nextbillion.ai services. You can reach out to [email protected] for an explanation. |